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Purpose 



We've designed this MM ££23£&BB££l3 £uide. 
to provide the information you need to know 
in order to write application software to run 
on 8086-family microcomputers under the 
TurboDOS operating system. This document 
explains the theory of operation of each 
internal facility of TurboDOS. It also 
describes in detail each TurboDOS function 
that may be called by an application program. 



Assumptions 



In writing this guide, we've assumed that you 
are an experienced assembly-language program- 
mer writing application programs for the 8086 
TurboDOS environment. We've also assumed you 
have read the £uxfej3P&S 1*4 JJsej^s £u±d£, and 
are therefore familiar with the commands and 
external features of TurboDOS. 



Organization 



This guide starts with a section that 
describes the fundamentals of the TurboDOS 
environment, with emphasis on the organiza- 
tion of memory and the interface and flow of 
control between application programs and the 
operating system. 

The next two sections explain TurboDOS inter- 
nals in more detail. One describes the file 
system, and the other describes serial I/O. 

There are two reference sections that explain 
each TurboDOS function call in detail. One 
section describes CP/M-compatible functions 
supported by TurboDOS, while the other 
describes functions unique to TurboDOS. 

Appendices describe the TurboDOS 80 86 assem- 
bler, linker, debugger, and PC-DOS emulator. 
The document concludes with a summary of 
function calls, and an alphabetical index. 
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Related Documents In addition to this guide, you might be 

interested in four other related documents: 

. TUL&2DQS 1*4 U££JLL§ Quite 

. TurfrQPQS IA ££M lBPl£B£Il££Xl§ Quite 

. TUJ&QDQS 1*4 Z&Q. PlQgx^BlPgr's £uid£ 

. lux&ms 1*4 IM lm£i£iDjeiiii?xl§ Quite 

You should read the USSllS Quite before you 
start into this document. It introduces the 
external features and facilities of TurboDOS, 
and describes each TurboDOS command in de- 
tail. 

You'll need the ££££ Jmpl£mjgnJfcO£l§ Quite if 
you are adapting TurboDOS to a new hardware 
configuration. It explains the system gene- 
ration and OEM distribution procedures, and 
also describes how to implement hardware- 
dependent driver modules. 

You'll need the Z80 guides if you are pro- 
gramming or configuring a TurboDOS system 
that uses Z80 microprocessors. 
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FUNDAMENTALS 



This section introduces you to the TurboDOS 
environment. Emphasis is given to the orga- 
nization of memory, and to the interface anu 
flow of control between application programs 
and the operating system. Subsequent sec- 
tions describe the file system and other 
facilities in detail. 



Memory Organization The resident portion of TurboDOS may be 

anywhere in the one-megabyte address space 
supported by an 80 86-family CPU. Usually, it 
is loaded at location 0040:0000 hex, 
immediately above the lower IK reserved by 
the 8086 architecture for interrupt vectors. 
Immediately following the TurboDOS resident 
is an area of memory reserved for disk 
buffers and other dynamic working storage. 
The remaining memory space available for use 
by commands and application programs is known 
as the "Transient Program Area" (TPA). 



Transient 
Program 
i\L ea 



0040:0000 
0000:0000 



Disk Buffers 

:£ajBic_ip&ee. 

TurboDOS 
JBJ£gxiupIIy,e,ciBx.S- 



I 
64K 

max 

1 



IK 



Under 8086 TurboDOS, several transient pro- 
grams may be loaded into the TPA at one time 
(although only one may be in execution) . 
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Execution Models 



8080 Model 



Transient programs are stored in files of 
type .CMD, preceded by a header record which 
defines the segmentation and memory alloca- 
tion requirements of the program. Transient 
programs may be written as a single group 
with intermixed code and data ("8080 Model"), 
with separate code and data groups ("Small 
Model"), or with up to eight separate groups: 
code, data, extra, stack, and up to four 
auxilliary groups ("Compact Model"). 



If the .CMD header defines only a code group, 
then it is assumed that the code and data 
portions of the program are intermixed. 
TurboDOS allocates a TPA segment sufficient 
to contain the code group. The first 256 
bytes of the code group is assumed to be a 
Base Page reserved for communications between 
the operating system and the program. 



CS:0100 
DS:0000 



Intermixed 
Code and Data 



I gage Page 



K--IP 

l<— CS,DS,ES 



40:0000 



96-Byte Stack Area l< — SP 

TurboDOS Resident I 

<— SS 



For this "8080 Model", TurboDOS initializes 
the CS, DS, and ES segment registers to 
address the single code group. The IP regis- 
ter is set to 0x0100 so that execution starts 
immediately following the Base Page. The SS 
and SP registers initially point to a 96-byte 
stack area provided within TurboDOS. 
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Small Model If the .CMD header defines both a code group 

and a data group, then it is assumed that the 

nndo and rlaf-a nrtrf innc r»-F <-V»<a nrnnrsm srp 

separate and independent. In this case, 
TurboDOS allocates separate TPA segments for 
the code group and the data group. The two 
allocated segments are not necessarily con- 
tiguous. The Base Page is assumed to occupy 
the first 256 bytes of the data group. 



I Code I 

I I 

CS:0000 I l<— CS,IP 



I I 

I I 

I Data I 

I I 

DS : 01 I I 

DS : 0000 I £a.se_J?ajge I < — DS, ES 



I 96-Byte Stack Area l<— SP 

I TurboDOS Resident I 
40:0000 I r _ I <-- SS 

For this "Small Model", TurboDOS initializes 
the CS register to the base of the code 
group, and initializes the DS and ES regis- 
ters to address the base of the data group. 
The IP register is set to zero. The SS and 
SP registers initially point to a 96-byte 
stack area provided within TurboDOS. 
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Compact Model 



If the .CMD header defines a code group r a 
data group, and one or more additional groups 
(extra, stack, or auxilliary), then TurboDOS 
allocates separate TPA segments (not neces- 
sarily contiguous) for each of the groups. 
The Base Page is assumed to occupy the first 
256 bytes of the data group. 



CS:0000 



DS:0100 
DS:0000 



ES:0000 



40:0000 



Code 



Data 
Base Page 



Extra Data 



Stack/Aux Group (s) 

96-Byte Stack Area 
TurboDOS Resident 



<— CS,IP 



<--DS 



<— ES 



< — Base Pg. 



<— SP 



<— SS 



For this "Compact Model", TurboDOS initial- 
izes the CS and DS registers to the base of 
the code and data groups, respectively. ES 
is set to the base of the extra group if 
present, otherwise to the data group. The IP 
register is set to zero. The SS and SP 
registers initially point to a 96-byte stack 
area provided within TurboDOS. The stack and 
auxilliary groups may be located via pointers 
in the Base Page. 
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Command Files 



A transient command file (type .CMD) always 
starts with a 128-byte header record that 

A^£ A m r\ a +- Vi *-n n/\««%An<- r»±-vn/-«4-i i i^^\ 5nd •>! 1 Anaf l An 
UC1111CO U11C OCyiUCllU OLlUV/k.ULC CL11V4 aXXV/V/UCXVU 

requirements of the transient program. The 
header record contains from one to eight 
"group descriptors", each nine bytes long. 
The balance of the 128 bytes is zero-filled. 

< rr-r.r.T-r~r— ,.123„ByjfcejB_,.rrr:--- -- -rrr; > 

I GDI LfiPJLi^^, J-fiDDL J-irrrr-JteXflfig-. rr r2- I 

Each 9-byte group descriptor has this format: 



I G-Type I G-Size i G-Abs I G-Min I G-Max I 
The G-Type field designates the group type: 



_£-£yj?e._ J_ 


fiJPup..Typ.e 


1 


or 9 


Code Group 


2 




Data Group 


3 




Extra Group 


4 




Stack Group 


d 




Aux-1 Group 


6 




Aux-2 Group 


7 




Aux-3 Group 


JB_ 


.», — ^— . i . . 


AllXri G£QU2~ 



The G-Size field specifies the number of 
paragraphs of loadable memory-image data to 
be read from the .CMD file for this group. 

The G-Abs field specifies an absolute base 
paragraph address for this group. The G-Min 
and G-Max fields specify the minimum and 
maximum number of paragraphs to be allocated 
for this group. Each of these three fields 
is ignored if zero. 

Following the header record, the command file 
contains the loadable portion of each group 
in memory-image format, in the same order as 
the group descriptors in the header record. 



1-5 



TurboDOS 1.4 8086 
Programmer's Guide 



FUNDAMENTALS 
Program Interface 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Program Interface 



C-Functions 



TurboDOS supports 119 different functions 
that may be invoked by an application 
program. Functions are provided for file 
management, memory management, console 
input/output, printing and spooling, and 
various other TurboDOS facilities. The last 
half of this guide is largely devoted to 
describing each of these functions in detail. 

Functions supported by TurboDOS fall into two 
categories: CP/M-compatible functions, and 
TurboDOS-unique functions. We will refer to 
them as "C-f unctions" and "T-f unctions", 
respectively. TurboDOS supports 76 C-func- 
tions and 43 T-Functions. 



To invoke a C-function, a program executes an 
interrupt instruction INT 224 (or INT OxEO) 
with a function number in the CL-register. 
TurboDOS supports all CP/M-86 BDOS functions: 



System Reset 

1 Console Input 

2 Console Output 
3*Raw Console Input 
4*Raw Console Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Cons. Buffer 

11 Get Console Status 

12 Return Version 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 

19 Delete File 



20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 
27*Get ALV Address 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get DPB Address 

32 Get/Set User Number 

33 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 

37 Reset Drive 
(38-39 reserved) 

40*Write Random 0-Fill 
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C-Functions 
(Continued) 



50 Direct BIOS Call 

51 Set DMA Base 

CO n^i- TMurn r>-.,-~ 
-j*. uct i/rirx case 

53 Alloc Max Memory 

54 Alloc Abs Max Mem 



55 Allocate Memory 

56 Allocate Abs Memory 

J/ cj.cc ricaiuj.y 

58 Free All Memory 

59 Program Load 



These C-functions are compatible with the 
corresponding CP/M-86 functions except for 
the four functions marked with an asterisk* 
C-functions 3 and 4 are compatible with MP/M- 
86 rather than CP/M-86. C-function 40 is 
synonymous with 34. C-function 27 performs no 
operation, but affects only the STAT utility 
of CP/M-86 which is not used with TurboDOS. 

TurboDOS also supports certain functions of 
MP/M-86 and Concurrent CP/M-86: 



42 Lock Record 136 

43 Unlock Record 137 

44 Set Multi-Sector 138 

46 Get Free Space 139 

47 Chain to Program 140 

104 Set Date/Time 141 

105 Get Date/Time 142 

107 Return Serial No. 143 

108 Get/Set Rtn Code 152 

110 Get/Set Delimiter 153 

111 Print Block 155 

112 List Block 160 

134 Make Queue 161 

135 Open Queue 



Delete Queue 
Read Queue 
Cond. Read Queue 
Write Queue 
Cond. Write Queue 
Delay 
Dispatch 

Terminate Process 
Parse Filename 
Get Console No. 
Get Date/Time 
Set List 
Cond. Attach List 



However, the following rarely-used functions 
are npt implemented in 8086 TurboDOS: 



41 Test and Write 
45 Set Error Mode 

48 Flush Buffers 

49 Get/Set SCB 
60 Call RSX 

98 Free Blocks 

99 Truncate File 



100 Set Dir. Label 

101 Get Dir. Label 

102 Read Passw'd Mode 

103 Write File XFCB 
106 Set Def. Passw'd 
109 Get/Set Cons Mode 
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T-Functions 



Termination 



To invoke a T-function, a program executes an 
interrupt instruction INT 223 (or INT OxDF) 
with a function number in the CL-register. A 
different entrypoint interrupt is used to 
avoid conflict with C-function numbers. 
TurboDOS supports the following T-f unctions: 



Reset O/S 22 

1 Create Process 23 

2 Delay Process 24 

3 Allocate Memory 25 

4 Deal locate Memory 26 

5 Send Message 27 

6 Receive Message 28 

7 Set Error Address 29 

8 Set Abort Address 30 

9 Set Date /Time 31 

10 Get Date/Time 32 

11 .Rebuild Disk Map 33 

12 Get TurboDOS S/N 34 

13 Set Compat. Flags 35 

14 Log-On/Log-Off 36 

15 Load File 37 

16 Activate Do-File 38 

17 Autoload On/Off 39 

18 Send Command Line 40 

19 Get Alloc Info 41 

20 Get Phys Disk Info 42 

21 Get/Set Drv Status 



Phys Disk Access 
Set Buffer Parms 
Get Buffer Parms 
Lock/Unlock Drive 
Fl ush/ F r ee Buf f er s 
Get/Set Print Mode 
Sig End-of-Print 
Get/Set Despl Mode 
Queue a Print File 
Flush List Buffer 
Network List Out 
Remote Console I/O 
Get Comm Status 
Comm Input 
Comm Output 
Set Comm Baud Rate 
Get Comm Baud Rate 
Set Modem Controls 
Get Modem Status 
User-Defined Func. 
Reorg Disk Directory 



A program may terminate by invoking C-func- 
tion (System Reset), or alternatively by 
executing a far-return instruction "RETF 
(provided the original values of the SS and 
SP registers are intact). Both methods are 
entirely equivalent, and cause TurboDOS to 
terminate the program in TPA and prompt for 
the next command. A program may also termi- 
nate by invoking C-function 47 (Chain to 
Program), which allows the program to specify 
the next command to be executed after the 
program terminates. 
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Command Processing A TurboDOS command always identifies a pro- 
gram file residing on disk, and causes that 
proaram to be loaded into memor* 7 (TPA) and 
executed. 



TurboDOS has no "built-in" corn- 



Command Prompt 



mands. 



TurboDOS comes with more than 30 standard 
command programs (described in detail in the 
User ' s Guide). You can expand the vocabulary 
of commands simply by storing additional 
programs on disk. Programs are usually kept 
in .CMD files. 



TurboDOS displays a command prompt on the 
console whenever it is ready to accept a 
command. The command prompt is composed of 
the current user number, the current drive 
letter, and the } prompt symbol. 



Command Format 



Each TurboDOS command consists of the file 
name of the program to be executed, possibly 
followed by an optional command tail of up to 
126 characters. A command may be entered in 
upper- or lower-case letters, but is conver- 
ted to upper-case by TurboDOS. 

The program name may have an explicit file 
type, but usually doesn't (TurboDOS assumes 
.CMD). It may also have a user/drive prefix 
(like "10:", "B: n , or n 5C: n ) to indicate that 
the program is under a particular user number 
or on a particular drive. You will get an 
error message if the program file cannot be 
found on disk, or if the available TPA is not 
big enough to hold the program. 

A special kind of command is used to change 
the current user number and/or drive. It 
consists of a user/drive prefix (like "10:", 
"B:", or "5C:") with no program name. 
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Tail Parsing The format of a command tail is determined by 

the particular program involved. TurboDOS 
passes the command tail to the program by 
saving the length of the tail (in characters) 
at location DS:0080 of the Base Page, and 
saving the text of the tail (up to 126 char- 
acters) starting at location DS:0081. 
TurboDOS also stores a null (zero byte) 
immediately following the last character of 
the command tail. The tail includes all 
characters following the program name, inclu- 
ding leading spaces. If no tail is given in 
the command, the length stored at DS:0080 is 
zero. 

If the command tail consists of one or two 
filenames of the form: 

{ uud : } f ilename { . typ} 

then TurboDOS parses each into File Control 
Block (FCB) format. The first parsed FCB is 
saved at location DS:005C of the Base Page, 
and the second parsed FCB is saved at loca- 
tion DS:006C. Parsing is done following the 
procedure described for C-function 152 (Parse 
Filename) . 



Command Strings TurboDOS also accepts strings of commands 

separated by the character \ (backslant). A 
command string may not exceed the size of the 
command buffer, which is normally big enough 
to accomodate two lines of text. 

TurboDOS executes each command of the command 
string in sequence. Normally, TurboDOS re- 
displays each command but the first as it is 
executed. However, the re-display is sup- 
pressed if the command string starts with a 
leading \ character. 
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Batch Processing TurboDOS supports a batch processing mode in 

which execution is controlled by a pre- 

file" on disk. A do-file is a text file 
(usually type .DO), each line of which con- 
tains a valid TurboDOS command or command 
string. A do-file may be activated with a DO 
command, or by invoking T-function 16 (Acti- 
vate Do-File)* A do-file may contain any 
number of embedded DO commands, and nesting 
is supported to any reasonable depth. 



Automatic Loading 



TurboDOS provides a facility for loading any 
program or executing any command sequence 
automatically at initial start-up (cold 
start) or whenever a program terminates (warm 
start). Autoload at cold-start takes place 
only if a file named COLDSTRT.AUT is present 
on the start-up disk. Autoload at warm-start 
takes place only if a file named WARMSTRT.AUT 
is present on the current disk. The AUTOLOAD 
command is the usual way to create these .AUT 
files. 

Alternatively, a program (.CMD file) may be 
autoloaded by renaming it as COLDSTRT.AUT or 
WARMSTRT.AUT. In this case, however, the 
autoloaded program must not rely on the 
contents of the Base Page FCB (at DS:005C) 
and buffer (at DS:0080), because they will be 
left uninitialized after the autoload. 
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Base Page Layout 



The Base Page is the 256-byte memory region 
from DS:0000 to DS:00FF. The Base Page is 
initialized by TurboDOS whenever a transient 
program is loaded, and is used for communica- 
tion between TurboDOS and the transient pro- 
gram. The organization of the Base Page is 
shown below: 

HeZIi55iIIiI"IIIIIlpiiiIiitIiB 

0000-0002 Length of code group in 

bytes. Stored as a 24 -bit 
number, least-significant 
byte first. 



0003-0004 Base paragraph address of 
code group. 

Q005 8080 Model flag, set to 1 

if 8080 Model, otherwise. 

0006-0008 Length of data group in 

bytes, 24 bits, LSB first. 

0009-000A Base paragraph address of 
data group. 

000B (Unused, reserved.) 

000C-000E Length of extra group in 

bytes, 24 bits, LSB first. 

000F-0010 Base paragraph address of 
extra group. 

0011 (Unused, reserved.) 

0012-0014 Length of stack group in 
bytes, 24 bits, LSB first. 

0015-0016 Base paragraph address of 
stack group. 
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Base Page Layout 
(Continued) 



-.fl.ex.Mdr i Ee££r Jjatioji 1 


0017 




0018-001A 


Length of aux-1 group in 1 




bytes, 24 bits, LSB first. 1 


001B-001C 


Base paragraph address of 1 




aux-1 group* i 


001D 


(Unused, reserved.) 1 


001E-0020 


Length of aux-2 group in 1 




bytes, 24 bits, LSB first. 1 


0021-0022 


Base paragraph address of 1 




aux-2 group. 1 


0023 


(Unused, reserved.) 1 


0024-0026 


Length of aux-3 group in 1 




bytes, 24 bits, LSB first. 1 


0027-0028 


Base paragraph address of i 




aux-3 group. 1 


0029 


(Unused, reserved.) 1 


002A-002C 


Length of aux-4 group in 1 




bytes, 24 bits, LSB first. 1 


002D-002E 


Base paragraph address of 1 




aux-4 group. 1 


002F-005B 


(Unused, reserved.) 1 


005C-006B 


Default FCB part 1. The 1 




first filename argument in 1 




a command tail is parsed 1 




into this 16-byte area. 1 
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Base Page Layout 
(Continued) 



.Mj3x~_J __Pe^j^ip±jUwi~. 



006C-007B Default FCB part 2. The 

second filename argument in 
a command tail is parsed 
into this 16-byte area, and 
must be moved to another 
location before making use 
of the default FCB. 

007C Default FCB current record. 

007D-007F Default FCB random record. 

0080-00FF Default 128-byte buffer. 

This area receives the com- 
mand tail length in 0x0080 , 
and the command tail text 
(up to 126 characters plus 
a null terminator) in loca- 
tions 0x0081-0x00FF. 
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System Start-Dp To get TurboDOS started, it is necessary to 

read a copy of the operating system from disk 
into memory, a process known as "cold start • 
The exact cold-start procedure depends on the 
particular hardware involved. 

Most TurboDOS implementations use this three- 
step cold-start procedure: 

1. When the computer is turned on or reset, 
it executes the TurboDOS bootstrap from 
read-only memory (ROM). (In some imple- 
mentations, the bootstrap may be loaded 
from reserved tracks on disk.) The 
bootstrap scans all disk drives from A 
to P, searching the directory of each 
ready drive for a file named OSLOAD.CMD 
which contains the TurboDOS loader. 
When this file is found, the bootstrap 
loads it into the TPA and executes it. 

2. The TurboDOS loader scans all disk 
drives from A to P, searching for a file 
named OSMASTER.SYS which contains the 
master operating system. When this file 
is found, the loader proceeds to load 
the operating system into memory, then 
transfers control to it. The drive from 
which the OSMASTER.SYS file was loaded 
becomes the "system disk". 

3. The master downloads a slave bootstrap 
routine into each slave processor. The 
master then locates a file named 
OSSLAVE.SYS on the system disk which 
contains the slave operating system, and 
downloads it into each slave processor. 

During network operation, it is helpful if 
the system disk is always on-line. If a 
fixed disk is available, it should be used as 
the system disk. 
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Summary This section has introduced the fundamentals 

of the TurboDOS environment. You have 
learned how memory is organized, how programs 
may be segmented into various execution 
models, and how .CMD files are formatted. 
You understand the TurboDOS program inter- 
face, including C-functions, T-functions, and 
direct BIOS calls. You know how TurboDOS 
parses and processes commands, command 
strings, and do-files, and how it communi- 
cates with programs via the Base Page. 

Next, we examine the TurboDOS file system in 
considerable detail. 
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FILE SYSTEM 



Disk Capacity 



This section describes the TurboDOS file 
system in detail. It covers the structure of 
disks and files, the facilities provided to 
manage files, and the procedures for calling 
these facilities from application programs. 



The TurboDOS file system can support up to 

oiXuccii luyiCai uiivcs pCx. ptOueofawif xUchUj. 

fied by the letters A through P. Drives may 
be local to the processor, or may be attached 
to another processor and accessed by means of 
networking. 

TurboDOS accomodates any combination of 
drives from mini-floppies to large hard disks 
in excess of a gigabyte. Allocation block 
size may be chosen individually for each 
drive, and affects maximum drive capacity as 
follows: 



i Alloc. 


-B1.QCJS- 


,5lZ£~ 


__L 


_l?aj^ Jxive_£apaciJ;y_ 1 




1K 






256 


Kilobytes i 




2K 






128 


Megabytes 1 




4K 






256 


Megabytes 1 




8K 






512 


Megabytes 1 




16K 






1,024 


Megabytes 1 



Because these limits are so big, it is almost 
never necessary to partition a physical drive 
into smaller logical drives under TurboDOS. 
However, such partitioning is sometimes done 
for user convenience when using large fixed 
disks. 

For maximum capacity and performance, floppy 
disks used with TurboDOS are generally for- 
matted with large sector sizes (512 or 1024 
bytes), no interleave, and no reserved 
tracks. However, TurboDOS also accomodates 
standard CP/M floppy disk formats. 
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Disk Organization Each disk is organized into five areas: 



File Storage 



Directory 



AHO£aJtion_l$ap 

. . VQlJ«R£-I»a££l 

^B&S££2l&&~Txa£k£ 

Reserved tracks are required by certain hard- 
ware configurations to support cold-start, 
but are not otherwise used by TurboDOS. The 
volume label permits a name to be given to 
each disk. The allocation map contains one 
bit for each allocation block on the disk, 
and is used by TurboDOS to keep track of 
which disk blocks are occupied and which are 
free. The directory is a table of contents 
which identifies all files stored on the 
disk. The remainder of the disk (most of it) 
is available for file storage. 

CP/M does not maintain a volume label or 
allocation map on the disks it creates. When 
a CP/M disk is first accessed by TurboDOS, 
the first few CP/M directory entries are 
automatically relocated to the end of the 
directory in order to make room for the label 
and map. When a TurboDOS disk is accessed by 
CP/M, the label and map appear to be ordinary 
deleted directory entries. Thus, disks can 
be moved freely between CP/M and TurboDOS 
in spite of the differences in organization. 
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Directory Formats 



TurboDOS supports two alternative directory 
formats: linear and hashed. A flag bit in 
the directory label indicates which format is 
in use on a particular disk. 

The standard linear format is compatible with 
CP/M, and is searched sequentially. Conse- 
quently, look-up speed deteriorates with 
increasing directory size, and can get pain- 
fully slow on large disks with many files. 



The optional hashed directory format uses a 
hashing algorithm to make look-up in large 
directories much faster. A hashed directory 
may be used on any disk, but is especially 
suited for use on hard disks with many files. 
Hashed directories are not media-compatible 
with CP/M, but may be converted to linear 
format whenever exporting to CP/M is needed. 

Whether the directory is linear or hashed, 
searches involving "wild cards" have to be 
done linearly. Such wild-card searches are 
typically slower if the directory is hashed. 



File Organization 



A file contains a sequence of 128-byte 
records, and may be up to 134 megabytes 
(1,048,576 records) long. The records of a 
file may be read and written sequentially or 
randomly (by relative record number). Up to 
128 records (16K) may be read or written in a 
single operation. A file may be extended by 
writing beyond the end of file. TurboDOS 
automatically allocates disk space when a 
file is extended, and deallocates it when a 
file is deleted. 

Text files are in ASCII with a RETURN (OxOD) 
and LINEFEED (OxOA) at the end of each line 
of text. Text lines are variable length and 
may span records. The end of a text file is 
marked by the character SUB (OxlA). 
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File Operations 



About half of the C-functions supported by 
TurboDOS are connected with the file system. 
These functions support the operations needed 
to manipulate files, directories, and disks. 

The following functions provide the basic 
facilities for sequential file access: 



,C-FcjU_. 

15 
16 
20 
21 
22 



£un££lQn-$am&- 



Open File 
Close File 
Read Sequential 
Write Sequential 
Make File 



These additional functions are necessary to 
support random access and file sharing: 



■ ■CHFcn ,) — 



,IiUl£JtifilL.JS3iBfi- 



33 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 

42 Lock Record 

43 Unlock Record 



Directory functions include: 



q-pcn I EU£££ioa~Name. 



17 Search for First 

18 Search for Next 

19 Delete File 
23 Rename File 

30 Set File Attributes 
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File Operations 
(Continued) 



Drive-oriented functions are: 



•-^rJkEIJwJ.-,*-.*-*-.. __£unc£ion_Najiie. 



1 14 


Select Disk 


1 24 


Return Login Vector 


1 25 


Return Current Disk 


1 28 


Write Protect Disk 


! 29 


Get R/O Vector 


1 31 


Get DPB Address 


1 37 


Reset Drive 


1 46 


Get Free Space 



Finally, some other functions connected with 
the file system include: 



1 C-F-SJlJ fJW*£j;iPJ}J8aiR§_ 1 


1 13 


Reset Disk System 1 


1 26 


Set DMA Address 1 


1 32 


Set/Get User Number 1 


1 44 


Set Multi-Sector Count 1 


1 47 


Chain to Program 1 


1 51 


Set DMA Base 1 


1 52 


Get DMA Address 1 


1 59 


Program Load 1 


1 152 


Parse Filename I 



Each of these file system C-functions is 
described in detail later in this document. 
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Naming Files TurboDOS keeps track of files by name, main- 
taining a directory of files on each disk. A 
file is identified uniquely by four fields: 

. user number (0-31) 

. drive letter (A-P) 

. file name (up to 8 characters) 

. file type (up to 3 characters) 

The user number specifies one of 32 logical 
file libraries on each disk. These libraries 
allow files to be conveniently segregated by 
user or application. Generally, user is 
reserved for global files and user 31 is 
reserved for log-on security, leaving 1-30 
for general use. If no user number is given, 
the current user number is assumed by 
default. 

The drive letter specifies the disk on which 
the file is located. If no drive letter is 
given, the current drive is assumed by 
default. 

The name and type fields are composed of 
ASCII characters. The file name may have up 
to eight characters, and the file type may 
have up to three. Shorter names and types 
are padded on the right with spaces. 

It is suggested that file names and file 
types be composed from the upper-case letters 
A-Z and the digits 0-9. Actually, any ASCII 
characters may be used including lower-case 
letters, punctuation, and even non-printing 
control characters. However, such names may 
not be parsed correctly in commands nor dis- 
played correctly in directories. 

The question mark ? is a special wild-card 
character which may be used in file names and 
types to match any character in the corre- 
sponding position during directory searches. 
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Special Pile Names TurboDOS gives special meaning to two 

reserved file names. "$.DIR" refers to the 



A1~-~~X.~ ^£ 

uiicttwiy aj.ca ui 



_ j 2 -. i. 
a ux a*. , 



refers to the entire contents of the physical 
disk volume (up to the maximum file size of 
134 megabytes). These special files may be 
dumped, patched, or accessed like any ordin- 
ary file. However, access is restricted to 






lege* 



1 nn—n 



0«~c — /"\ r*i <3 r\n 1 tt 



File Control Block 



File-oriented C-functions and T-functions are 
always called with the address of a File 
Control Block (FCB) in the DX-register. The 
FCB is a data structure 33 bytes long (36 
bytes for random access operations) organized 
as follows: 

..Qff^iJLi Zi£lB 1 Pesj?x±pIL?B 







i — o 



9-11 



12 



drive drive code (0-16) : 

-> current drive 

1 -> drive A 

2 -> drive B 

16 -> drive P 

name file name in ASCII, 
padded on right with 
spaces, high-order bit 
of each byte reserved 
for attributes fl-f8 

type file type in ASCII, 
padded on right with 
spaces, high-order bit 
of each byte reserved 
for attributes tl-t3 

extent least significant five 
bits of extent number 
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File Control Block 
(Continued) 



13 
14 

15 

16-31 

32 

33-35 



J E±Sl& I D££CjipJfci££ 

sped flag byte (Do Not Use) 
spec 2 



record 
count 

map 



current 
record 



random 
record 



most significant eight 
bits of extent number 

number of records in 
current extent (0-128) 

allocation map of cur- 
rent extent 



current 
(0-127) 
tent 



record number 
in current ex- 



20-bit record number 
(byte 33 is least sig- 
nificant) for random- 
access operations 



In general, the application program must 
initialize FCB bytes 0-12 before opening, 
making, or searching for a file. It must 
also zero FCB byte 32 before reading or writ- 
ing a file sequentially from the beginning. 

When a file is opened, TurboDOS fills FCB 
bytes 0-31 with information from the direc- 
tory. Thereafter, the application program 
should not modify FCB bytes 0-31. When the 
file is closed, TurboDOS updates the direc- 
tory with information from the FCB. A direc- 
tory entry has the same structure as the 
first 32 bytes of an FCB. In a directory 
entry, however, byte contains the user 
number 0-31 to which the file belongs, or the 
value 0xE5 if the directory entry is not in 
use. Also, byte 13 may contain the exact 
byte count of the last record in the file. 
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File Attributes 



File attributes are stored in the high-order 
bits of the FCB name field bytes fl-f8 and 

uypc Liciu uy tea ti-tO/ anu cue 

trol how a file may be accessed: 



Att ribute I. 

fl 

f5-f8 
tl 
t2 
t3 



.PsIlJliJtiSB- 



FIFO file attribute 



! r^.A^-P A 



lA f il 



+-4- v -i Knf , 



nderined file attributes 
interface attributes 
read-only file attribute 
global file attribute 
archived attribute 



The file attribute bits fl-f4 and tl-t3 are 
recorded in the directory, and may be set or 
cleared by means of C-function 30 (Set File 
Attributes). For a newly-created file, all 
attribute bits are initialized to zero. When 
a file is opened, its attributes are copied 
into the FCB. File attributes may also be 
interrogated by means of C-functions 17 and 
18 (Search for First/Next). 

The read-only attribute (tl) prevents a file 
from being written, deleted or renamed. The 
global attribute (t2) enables a file saved 
under user to be accessed from any user 
number (it has no effect for files saved 
under non-zero user numbers). The archived 
attribute (t3) is used for incremental file 
backup, and is automatically cleared by 
TurboDOS whenever a file is written or 
renamed. The FIFO attribute (fl) causes a 
file to be accessed using a special n first-in 
first-out" access method (described later). 

Attributes f2-f4 are undefined, and available 
to the user. Interface attribute bits f5-f8 
cannot be used as file attributes; they 
specify options for certain C-functions. 
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User Numbers 



TurboDOS provides 32 file libraries on each 
disk corresponding to user numbers 0-31. 
Generally, user is reserved for global 
files and user 31 is reserved for log-on 
security, leaving 1-30 for general use. 

The current user number is established ini- 
tially at log-on. For a non-privileged log- 
on, the user number remains unchanged until 
log-off. This restricts file access to the 
corresponding file library (plus global files 
uh~def"user 0). For a privileged log -on, the 
user number may be changed without restric- 
tion by means of C-function 32 (Set/Get User 
Number) . 

The current user number is treated as a pre- 
fix to file names, thereby allowing each disk 
directory to contain up to 32 libraries. 
Most directory functions (make, rename, 
delete, search, etc.) are restricted to the 
library corresponding to the current user 
number. However, files in the user library 
which have the global file attribute may be 
opened from any user number. This permits 
commands, programs, and other common files to 
be shared by all users. 



File Sharing 



In a multi-user TurboDOS system, it is pos- 
sible for multiple users to access the same 
file at the same time. This can happen if 
the users are logged-on to the same user 
number, or accessing the same global file. 
TurboDOS supports interlocks to regulate such 
file sharing at the file or record level. 

TurboDOS file sharing facilities are compa- 
tible with MP/M, but provide significant 
extensions to alleviate the most serious 
deficiencies in MP/M file sharing. 
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File Locks File-level interlocks are supported by means 

of four distinct modes of opening a file. 
The open mode is determined by FCB "interface 
attributes f5-f6 when the file is opened or 
created. The four open modes are called 
exclusive, shared, read-only, and permissive. 

ex liac wt^ncu jlju sjheAMfLjJdZ uiuue j.t> av<aAJ.aDj.e 
to the opening process exclusively until it 
is closed, and may not be opened by any other 
process. A file cannot be opened in exclu- 
sive mode if the file is currently opened (in 
any mode) by another process. 

A file may be opened in jsJjajce^ mode by any 
number of processes simultaneously. All 
processes are allowed to read, write and 
extend the file. Record lock and unlock 
functions are honored only for file opened in 
shared mode. 

A file may be opened in Lsa&zQnlX mode by any 
number of processes simultaneously. All 
processes are allowed to read the file, but 
not to write or extend it. 

A file may be opened in ££XBAjsJzlll£ mode by 
any number of processes simultaneously. All 
processes are allowed to read the file. If 
any process writes or extends the file, then 
that process gains an exclusive write-lock on 
the file, preventing any other process from 
writing to the file. The exclusive write- 
lock is released when the locking process 
closes the file. 

In shared and permissive modes, if a process 
extends a file by adding new records at the 
end, these records become immediately acces- 
sible to other processes that also have the 
file open. 
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Record Locks Record-level interlocks are controlled by 

means of explicit locking and unlocking 
requests made by the application program. 
This allows concurrent update by multiple 
processes. 

Record locks are by no means automatic, and 
require explicit cooperative participation by 
all updating programs. C-functions 42 (Lock 
Record) and 43 (Unlock Record) are honored 
only for files opened in the shared mode. 
Each program must lock a record before read- 
ing it, and must unlock the record after 
updating it. 

If a program attempts to lock a record that 
is already locked by another process, the 
Lock Record function returns an error code 
and the program must try again until it is 
successful. Alternatively, the program can 
ask TurboDOS to suspend program execution 
automatically until the lock request can be 
satisfied. 

To extend a shared file in a concurrent 
update environment, the extending program 
should first acquire a lock on record N+l 
(where N is the last record in the file). 
The program may then safely write record N+l, 
and finally unlock N+l. 
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Compatibility Modes The file sharing facilities of TurboDOS are 

designed to provide compatibility with MP/M, 
yet at the same time to alleviate the most 
serious limitations of MP/M file sharing. 
TurboDOS may be instructed to adhere strictly 
to MP/M file-sharing rules, or alternatively 
to relax some of these rules. To this end, 
TurboDOS provides a byte of "compatibility 
flags" with the following bit assignments: 



jaut-i.-JEiagLiaaffifi.-i btts&s 



7 permissive 

6 suspend 

5 global-write 

4 mixed-mode 

3 logical 

2-0 (not defined) 



default open mode 
lock conflict action 
writing global files 
mixed file open modes 
record lock validity 



For each compatibility flag, a zero-bit de- 
notes strict adherence to the MP/M rule, 
while a one-bit signifies a relaxation of 
that rule. The initial setting of the com- 
patibility flags may be established during 
TurboDOS system generation by assigning the 
desired value to the symbolic location 
COMPAT. A program may modify its compati- 
bility flags by calling T-function 13 (Set 
Compatibility Flags), but the flags automati- 
cally revert to their initial setting when 
the program terminates. 

If the szzmiSSius flag (bit 7) is set, the 
default file open mode is permissive, rather 
than exclusive (as in MP/M). Specifically, 
the open mode is determined when a file is 
opened or created by FCB interface attributes 
f5-f6, as shown in the following table: 
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Compatibility Modes 
(Continued) 



_JE£.JE.§-J_oj?ej3_j 





1 

1 
1 1 



exclusive 
shared 
read-only 
read-only 



_JE£_I5-J~O^£n_IR0il£ — 

permissive 

1 shared 

1 read-only 
1 1 exclusive 



If the j5ii5P£J)i3 flag (bit 6) is set, then an 

at tempt to 1 oc k __a_ record that is already 

locked by someone else causes the process to 
be suspended until its lock request can be 
satisfied. Otherwise, an attempt to lock or 
write to a record that is already locked by 
someone else results in an immediate error 
return code (as in MP/M) . 

If the 5lcJbfllr^xiJt£ flag (bit 5) is set, then 
a program running under a non-zero user 
number may both read and write global files. 
Otherwise, access to global files is strictly 
read-only (as in MP/M). 

If the ml££&-&Q&£ flag (bit 4) is set, then 
one process may open a file in shared mode 
while another has it open in read-only mode 
(or vice-versa). Otherwise, the shared and 
read-only modes are mutually exclusive (as in 
MP/M) . 

If the Isglsal flag (bit 3) is set, then the 
FCB random record field for C-functions 42 
and 43 (Lock/Unlock Record) is interpreted 
as an arbitrary 24-bit logical record number 
which is not validated and does not cause 
file positioning. Otherwise, the FCB random 
record field for C-functions 42 and 43 is 
interpreted as the relative number of a 128- 
byte record, and causes the file to be posi- 
tioned to that record (as in MP/M?. 
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FIFO Files 



To facilitate communications between proces- 
ses, processors and users, TurboDOS supports 

-» r- »n ~ ^ -J -, 1 !*. i .* j ~. c c i ~\ -. >-.-. T 1 ^ ^ -, ot c»r» / -P l «• «*. _ 
a o £s c v~ j. a j. Miiu ui. j_aj-c uancu a cx£u miibl - 

in, first-out) similar in concept to a Unix 
pipe. FIFOs are opened, closed, read and 
written exactly like ordinary sequential 
files. However, a record written to a FIFO 
is always appended to the end, and a record 

rpa^ f rntn a PTKTl -5 e alMa^re +- a V p n f rnm +-V»<a 

beginning and removed from the FIFO. 

A FIFO is differentiated from other files by 
the presence of the FIFO attribute (fl) in 
the directory. Record zero of a FIFO is a 
header record used by TurboDOS to keep track 
of the FIFO, and is organized as follows: 



M£Me£„J £cnfc£Bfc& 



type (0=RAM, -l=disk) 

1 mode (0=error code, -l=suspend) 
2-3 maximum size (records) 

4-5 current size (records) 

6-7 number of last record read 

8-9 number of last record written 

10-127 (not used, reserved) 



The header specifies whether the body of the 
FIFO is RAM- or disk-resident, and the maxi- 
mum number of records it may contain. RAM- 
resident FIFOs provide high-speed but limited 
capacity (up to 127 records, usually much 
less). Disk-resident FIFOs provide large 
capacity (up to 65,535 records) but slower 
speed. The FIFO command may be used to 
create a FIFO and initialize its header. 
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FIFO Files 
(Continued) 



Queue Emulation 



Normally, reading from an empty FIFO returns 
an end-of-file code (A=l), and writing to a 
full FIFO returns a disk-full code (A=2). 
However, if the mode byte in the FIFO header 
is set to -1 (suspend), then reading from an 
empty FIFO or writing to a full FIFO causes 
the process to be suspended until the FIFO 
becomes non-empty or non-full. 

The header or disk-resident body of a FIFO 
may be accessed -directly using C-f unctions 33 
and 34 (Read/Write Random), thereby bypassing 
the normal first-in first-out protocol. An 
attempt to make (C-function 22) an existing 
FIFO is treated as an open (C-function 15), 
while an attempt to delete (C-function 19) a 
FIFO is ignored. The only way to get rid of 
a FIFO is first to clear the FIFO attribute, 
then delete it. 



In order to support applications that depend 
on queues, TurboDOS emulates the queue faci- 
lity of MP/M and Concurrent CP/M by using RAM 
FIFOs. Queue-related C-functions include: 



l-JSrJ&CDL-L 


fUBCjfcipj^ame. 1 


1 134 


Make Queue 1 


1 135 


Open Queue 1 


1 136 


Delete Queue 1 


1 137 


Read Queue 1 


1 138 


Conditional Read Queue 1 


1 139 


Write Queue 1 


1 140 


Conditional Write Queue 1 



C-function 134 (Make Queue) creates a RAM 
FIFO with the specified queue name (mapped to 
upper case) and type ".QUE", while the other 
queue-related C-functions operate on such 
FIFOs. (See the description of C-function 
134 for details and limitations.) 
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Buffer Management The TurboDOS buffer manager performs multi- 
level buffering of physical disk input/out- 

—.... x- .-„-•__ i ^ _ *. j_ __™__i_n., .. ~ ^ J I r Ttrt \ V. ii C C ~* —■ 

puu, uoxny lcasu-icweauiy-uBcu vuau/ uuilci 

assignment and other sophisticated optimiza- 
tions. Buffering provides a manyfold reduc- 
tion in the number of physical disk accesses 
during both sequential and random file opera- 
tions. 

The number and/or size of disk buffers may be 
changed by means of T-function 23 (Set Buffer 
Parameters), and interrogated by T-function 
24 (Get Buffer Parameters). The number of 
buffers must be at least two, and the buffer 
size must be at least as large as the physi- 
cal sector size of the disks being used. For 
optimum performance, the number of buffers 
should be as large as possible consistent 
with the TPA size required. 

The buffer manager maintains its buffers on 
two lists: the "in-use" list and the "free" 
list. Whenever the file manager requests a 
disk access, the buffer manager first checks 
the in-use list to see if the requested disk 
sector is already in a buffer. Most of the 
time it is, and no physical disk access is 
required. If not, the buffer manager at- 
tempts to acquire a new buffer from the free 
list. If the free list is empty, the least- 
recently-used buffer (at the end of the in- 
use list) is written out to disk if neces- 
sary, and then reused to receive the newly 
requested disk sector. 
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Media Changes Before a removable disk volume is changed, it 

is crucial that any buffers relating to that 
disk are written out if necessary, and re- 
turned to the free list. In single-user 
configurations of TurboDOS, this is done 
automatically whenever the system pauses for 
console input. In multi-user configurations, 
buffers must be explicitly flushed and freed 
by calling T-function 26 (Flush/Free Buffers) 
prior to changing disks. This is most com- 
monly done by executing the CHANGE command, 
but should also be coded into applications 
that require media changes during operation. 
For safety, TurboDOS also flushes buffers 
automatically during any lull in system acti- 
vity, and frees them automatically whenever a 
disk drive becomes not-ready. 
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Error Handling 



In the event of an unrecoverable disk error, 
TurboDOS normally displays a diagnostic mes- 
sage in one of these formats; 



Read Error, Drive A, Track 0, Sector 2 
[Retry, Ignore, Abort] 

Write Error, Drive B, Track 5, Sector 16 
[Retry, Ignore, Abort] 

Not Ready Error, Drive C [Retry, Abort] 

Spooler Error [Ignore, Abort] 



and waits for the user to choose the desired 
recovery option by keying in the appropriate 
letter (R, I or A). 

An application program may elect to intercept 
and process such errors, however, by calling 
T-function 7 (Set Error Address). In this 
case, TurboDOS does not display its usual 
diagnostic messages. Normal error processing 
resumes automatically when the application 
program terminates. 

NOTE: Because the buffer manager optimizes 
disk write operations by deferring them as 
long as possible, write errors may be repor- 
ted later than expected and possibly even to 
a different user than expected. 
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SERIAL I/O 



Console I/O 



This section describes the TurboDOS facili- 
ties that deal with serial input/output (I/O) 
in connection with consoles, printers, and 
communications channels. 



TurboDOS provides ten C-functions that permit 
programs to interact with the user console 

J ,^-, i **,~. rn1_ ~» ^ <■* \r 1 ■—. A r* nf /^/M^rjrtl /> i nrMi<- //mi4-tmi4- 

UCViWCt J.XIJ.CC IS.1UUS \J1. ^VUOWXC iUpuu/ uutyu w. 

are supported in TurboDOS: basic I/O, raw 
I/O, and string I/O. 



Basic Console I/O 



Three C-functions provide basic console I/O 
on a single-character basis: 



i .c-F£ilJ-„ JEiuiffJtiflJX.JS[a»fi 

1 Console Input 

2 Console Output 
11 Get Console Status 



The Console Input function waits for a char- 
acter to be keyed in, echoes the character to 
the console screen to provide visual confir- 
mation, and returns the character to the 
calling program. 

The Console Output function displays a char- 
acter on the console screen. It expands hori- 
zontal tab characters into spaces, based upon 
tab stops at every eighth column. 

The Get Console Status function checks to see 
whether or not a console input character is 
available, and returns a Boolean result. 
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Raw Console I/O 



Three additional C-functions provide raw 
console I/O: 



C-FcjxJ 



£ujjc£ion_J$ame_. 



3 Raw Console Input 

4 Raw Console Output 
6 Direct Console I/O 



String Console I/O 



The Raw Console Input function is similar to 
the basi c Console Input function, e xeept that 
input characters are not echoed to the 
screen. Likewise, the Raw Console Output 
function is like the basic Console Output 
function, except that horizontal tabs are not 
expanded. 

The Direct Console I/O function combines the 
functions of Raw Console Input, Raw Console 
Output, and Console Status. It is supported 
only for compatibility with CP/M. 



The remaining console I/O functions provide 
input and output of character strings: 



-£zE£n-A fujjcJfcioj^JHams. 

9 Print String 

10 Read Console Buffer 

110 Get/Set Delimiter 

111 Print Block 



The Print String function outputs a string of 
characters to the console. The string may be 
of any length, and is terminated by a re- 
served delimiter. The delimiter is normally 
the dollar-sign $ character, but may be 
changed by means of the Get/Set Delimiter 
function. 
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String Console I/O 
(Continued) 



The Print Block function is similar to Print 
String, except that the string length is 
passed explicitly so that no delimiter is 
needed. Both Print String and Print Block 
expand horizontal tabs. 

The Read Console Buffer function reads an 
entire line of edited input from the console. 
Characters are accepted from the console and 
stored in successive memory locations until a 
carriage-return terminates the line. Input 
characters are echoed to console output (but, 
unlike CP/M, tabs are not expanded). Rudi- 
mentary editing is supported: backspace or 
delete characters erase the last typed char- 
acter, while CTRL-U or CTRL-X erase the 
entire line. 



Console 
Identification 



Certain multi-user application programs need 
to identify uniquely the console to which 
they are attached. TurboDOS supports this 
requirement with two C-functions: 

L£dblLI I^licIionJSame. 

12 Return Version 
153 Get Console Number 



C-function 153 (Get Console Number) is compa- 
tible with Concurrent CP/M and MP/M, return- 
ing an 8-bit console number. Under TurboDOS, 
this console number is only guaranteed to be 
unique in simple (one circuit) networks. 

C-function 12 (Return Version) returns a 16- 
bit network address that is unique even in 
complex TurboDOS networks. 
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Attention Requests The execution of a program or do-file may be 

suspended at any time by typing a reserved 
"attention" character on the console key- 
board. In most installations, this is either 
CTRL-§ or BREAK. TurboDOS will "beep" to 
acknowledge that it has received the atten- 
tion request. 

After an attention request, the interrupted 
program or do-file will remain suspended 
until one of the following attention respon- 
ses is typed: 

CTRL-* (resume) simply restarts execution at 
the point of interruption. 

CTRL-C (abort) cancels execution of the in- 
terrupted program or do-file, causes any 
nested commands and do-files to be disregar- 
ded, and returns to the command prompt. An 
application program may elect to intercept 
such abort requests, however, by calling T- 
f unction 8 (Set Abort Address). 

CTRL-P (echo-print) restarts execution and 
causes all subsequent console output also to 
be echoed to the printer. A second atten- 
tion/echo sequence turns off echoing of con- 
sole output to the printer. 

CTRL-L (end-print) restarts execution after 
signalling the end of the current print job. 
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Comm Channel I/O 



In order to allow communications-oriented 
applications programs to be written in a 

harHuaro-indonDndoTif f achinn. TiirhnnOfi esiTD— 

ports a standard communications channel in- 
terface consisting of seven T-functions: 



^T=E£2-1 ^_-.J , JjncJtipji-.JSaiB£ . 

34 Get Comm Channel Status 

35 Comm Channel Input 

36 Comm Channel Output 

37 Set Comm Channel Baud Rate 

38 Get Comm Channel Baud Rate 

39 Set Comm Channel Modem Controls 

40 Get Comm Channel Modem Status 



These functions support multiple channels of 
communications. T-functions 34-36 provide 
basic single-character comm channel I/O (ana- 
logous to raw console I/O). T-functions 37- 
38 allow programs to sense or set the comm 
channel baud rate to any standard speed from 
50 to 19,200 baud. T-functions 39-40 allow 
programs to set modem control signals (RTS, 
DTR) and to sense modem status signals (CTS, 
DSR f DCD, RI). 
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Printer Output 



Basic Printing 



TurboDOS provides the basic printing func- 
tions of CP/M, plus an elaborate concurrent 
printing facility which offers several modes 
of print spooling and flexible print routing 
among multiple printers and print queues. 
The spooling and routing facilities are com- 
pletely transparent to application programs. 

Two C-functions provide the basic means for 
programs to generate printer output: 

1 .C-FSj£j fJJJJJcIiSB-Bame. , 

5 List Output 

112 List Block 



The List Output function outputs a single 
character to be printed, while the List Block 
function outputs a character string of speci- 
fied length. In contrast to console I/O, 
these print output functions do not expand 
tabs. 
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Control Functions 



Four T-functions provide control over the 
print spooling, de-spooling, and queuing 

•mor , V»an i cm c r»-F TnrhnnTlC* 



~2zE£Q-l .„ ^J3£j;ipn.~]!te m -£- 

27 Get/Set Print Mode 

ao Signal End—or —Print 

29 Get/Set De-Spool Mode 

30 Queue a Print File 



The Get/Set Print Mode function controls 
print routing. Print output may be routed 
direct to a specified printer, spooled to a 
specified drive and print queue, displayed on 
the console, or simply discarded. 

The Signal End-of-Print function allows a 
program to terminate a print job explicitly. 
In the absence of this function, a print job 
ends automatically at the conclusion of the 
program, upon receipt of an end-print atten- 
tion request from the console, or when a 
reserved end-of-print character (if defined) 
appears in the print output stream. 

The Get/Set De-Spool Mode function controls 
background printing (de-spooling). A printer 
may be assigned to de-spool from a specified 
queue, or may be placed in an off-line 
status. Any print job in process may be 
stopped, resumed, restarted from the begin- 
ning, or terminated altogether. 

The Queue a Print File function permits a 
program to queue a print file (or any text 
file, for that matter) for background print- 
ing. The file may be placed on any specified 
print queue, and may be saved or deleted 
automatically after printing. 
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C-FUNCTIONS This section describes the CP/M-compatible 

functions ("C-functions") supported by Turbo- 
DOS. The C~*f unctions are ^resented in numer— 
ical order, with calling parameters, return 
value, and a detailed explanation for each. 

To invoke a C-function, a program executes an 
interrupt instruction INT 224 (or INT OxEO) 
with a function number in register CL. Byte- 
length arguments are passed in register DL, 
and word-length arguments in register DX. In 
the case of a memory location argument, the 
segment base is passed in DS and the offset 
in DX. 

C-functions return byte-length values in 
register AL (duplicated in BL) , or word- 
length values in register BX (duplicated in 
AX). A few functions return memory location 
values in ES (base) and BX (offset). 

If a C-function call is made with register CL 
set to an unsupported function number, Turbo- 
DOS returns immediately with registers BX and 
AX zeroed. 

C-function calls generally destroy registers 
AX-BX-CX-DX-SI-DI-BP-ES but preserve SP-IP 
and CS-DS-SS. 
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C-Function 

Entry Arguments 

Explanation 



System Reset 




P£££ji.PJt±QJ3w. 



I CL = 



The System Reset function terminates the 
calling program ("warm-start"). Program ter- 
mination also may be accomplished by execu- 
ting a far return instruction RETF (provided 
the original values of registers SS and SP 
have been preserved) and has exactly the same 
effect. 

Program termination ends any active print 
job, and restores the current user number and 
current drive that were in effect when the 
program was originally loaded into TPA. In a 
multi-user TurboDOS system, program termina- 
tion closes any open files, and releases any 
locked records or devices. 
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Console Input 



Entr ,r Arguments 



I Pan I 



CL = 1 



DoRrrinf inn I 



Returned Value 



Explanation 



£&2-l P£Sj?£ip£iojL_ 

AL = input character 



The Console Input function obtains the next 
character from the console keyboard, and 
returns it in register AL. If no character 
is available, the calling program is suspen- 
ded until a character is typed. 

Graphic characters and certain control char- 
acters (carriage-return, line-feed, and back- 
space) are echoed to the console screen. 
Horizontal tabs are expanded into multiple 
spaces, based upon tab stops at every eighth 
column. 
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C-Function 2 Console Output 



Entry Arguments 



Reg J ™ SiixIpiiBjx 



CL = 2 

DL = output character 



Explanation The Console Output function displays the 

character passed in register DL on the con- 
sole screen. Horizontal tabs are expanded 
into multiple spaces, based upon tab stops at 
every eighth column. 
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C-Function 3 






Raw Console Input 




Returned Value 



Explanation 



I ., Rsg-J. P£JSJ£lip.£i QJX 

I 

AL = input character 



L. 



The Raw Console Input function obtains the 
next character from the console keyboard, and 
returns it in register AL. If no character 
is available, the calling program is suspen- 
ded until a character is typed. Input char- 
acters are not echoed to the console screen. 

This function is compatible with MP/M-86. 
(In CP/M-86, this function is Input from 
Reader Device* In Concurrent CP/M- this 
function is Auxiliary Input.) 
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C-Function 4 Raw Console Output 

Entry Arguments 



,PeggJip£iQJ3u. 



CL - 4 

DL = output character 

Explanation The Raw Console Output function displays the 

character passed in register DL on the con- 
sole screen. Horizontal tabs are not expan- 

ded. 

This function is compatible with MP/M-86. 
(In CP/M-86, this function is Output to Punch 
Device. In Concurrent CP/M, this function is 
Auxiliary Output.) 
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C-Function 5 
List Output 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 5 



Pnt-r-tr Irnnmonfe 

i-l*XWJ.V lit. ^UUIbllbU 



Explanation 



List Output 



I Don I DofiC'' "1 *">"•" 1 ftTl 



CL = 5 

DL = output character 



The List Output function sends the character 
passed in register DL to be printed according 
to the current print routing. Horizontal 
tabs are not expanded. 
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C-FDNCTIONS 

C-Punction 6 
Direct Console I/O 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 6 

Entry Arguments 



Direct Console I/O 



1 fieg [ 

I 

I CL 

I DL 



. -JD^Sjexipiicji I 



6 I 

-1 (for combined status/input) I 

-2 (for status) I 

-3 (for raw input) I 

output character (for raw output) I 



Returned Value 



Explanation 



I Reg 1 JQ£££j ipiipii 

I 

I AL = input character or status 



The Direct Console I/O function performs one 
of .four possible sub-functions, depending 
upon the argument passed in register DL. 

If DL = -1 (OxFF), then any available console 
input character is returned in register AL, 
without echo to the screen. If no character 
is available, the function returns AL = 0. 

If DL = -2 (OxFE), then this function returns 
console status (A = if no console input is 
available, or AL = -1 otherwise). Equivalent 
to C-f unction 11 (Get Console Status). 

If DL = -3 (OxFD), then this function obtains 
the next console input character and returns 
it in register AL, without echo to the 
screen. If no character is available, the 
calling program is suspended until a charac- 
ter is typed. Equivalent to C-f unction 3 
(Raw Console Input). 

For other values of DL, this function dis- 
plays the character on the console screen. 
Horizontal tabs are not expanded. Equivalent 
to C-f unction 4 (Raw Console Output). 
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(Continued) 

Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

C-Function 6 Note that the 8086 TurboDOS implementation of 

(Continued) this function is compatible with MP/M-86, 

PA Mn< i.« M «*. r«-n/iur r«Ti/iui_on -» r\ A «7 Q H iPnrKATinc 

It differs somewhat from the implementation 
in CP/M-86, however. 
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C-Function 7 
Get I/O Byte 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 7 

Entry Arguments 



Get I/O Byte 

I Reg | pescrjptj-pn , 

I 

I CL = 7 



Returned Value 



Explanation 



I Reg | 



PejgcjcipJti 




I 

I AL = contents of I/O byte 

This function simply returns the value of the 
memory location identified by the public name 
IOBYTE# (used in some implementations to 
control serial I/O device assignment). 

NOTE: This function is supported and IOBYTE# 
is defined only if the optional module CPMSUP 
is included during TurboDOS system genera- 
tion. 



4-10 



TurboDOS 1*4 8086 
Programmer s Guide 



C-PDNCTIONS 

C-Punction 8 
Set I/O Byte 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 8 



Eirt-rxr Rrnnmonf c 



Explanation 



Set I/O Byte 

I Pan I 

" fltH^Tiilrl _ r i | _ I,, ,_ , r | , ru , 



JBfi&gxlpilsix 



CL = 7 

DL = new value of I/O byte 



This function simply sets the value of the 
memory location identified by the public name 
IOBYTE# (used in some implementations to 
control serial I/O device assignment). 

NOTE: This function is supported and IOBYTE* 
is defined only if the optional module CPMSUP 
is included during TurboDOS system genera- 
tion. 
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C-PUNCTIONS 

C-Punction 9 
Print String 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Punction 9 

Entry Arguments 



Explanation 



Print String 

Reg | Description 

CL = 9 

DS:DX = string address 



The Print String function displays a string 
of characters on the console screen. The 
string may be of any length, and is termina- 
ted by a reserved delimiter. The delimiter 
is normally the dollar-sign $ character, but 
may be changed by means of C-function 110 
(Get/Set Output Delimiter). Horizontal tabs 
are expanded into multiple spaces, based upon 
tab stops at every eighth column. 
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C-Function 10 
Read Console Buffer 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 10 






Explanation 



Read Console Buffer 



I "Parr I naonrinfinn 



CL = 10 

DS:DX = buffer address 



The Read Console Buffer function reads an 
entire line of edited input from the console. 
The input buffer whose address is passed in 
registers DS:DX has the following structure: 

^CfiEsL— 3.BiXfi^JJBJlJ- D£.§ciipii£n 




1 
2 to N+l 



passed max input size (N) 
returned actual input (0-N) 
returned input characters 



The first byte of the buffer must be preset 
to the maximum number of characters allowed 
in the input line. 

Console input is accepted until terminated by 
a carriage-return. Input errors may be cor- 
rected by typing BACKSPACE or DELETE to erase 
one character at a time, or CTRL-U or CTRL-X 
to erase the entire line. Characters in 
excess of the maximum are not accepted, and 
diagnosed with a "beep". Input characters 
are echoed to the console screen. Unlike 
CP/M, this function does not expand tabs in 
TurboDOS. 

Upon return, the second byte of the buffer 
contains the actual number of input charac- 
ters in the buffer. The input line is 
returned starting at the third byte of the 
buffer. The terminating carriage-return is 
neither stored in the buffer nor included in 
the count. Unused buffer positions following 
the last input character are uninitialized. 
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C-Function 11 
Get Console Status 
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C-Function 11 

Entry Arguments 



Get Console Status 

i 

I CL = 11 



Returned Value 



Explanation 



JD^^if&lojL.. 



I AL » 



-1 if console input is available I 
if console input is not available I 



The Get Console Status function checks to see 
whether or not a console input character is 
available. If console input is available, it 
returns AL * -1, otherwise it returns AL = 0. 
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C-Function 12 
Return Version 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 12 






Returned Values 



Return Version 



t T3asy I 
I ,- *>.CJtf ... -J. 



-JBl 



CL « 12 



i Beg i 



.Ps.s.cjip£ioj}_ 



BH = 0x00 (meaning: CP/M, not MP/M) 
BL = 0x31 (meaning: BDOS version 3.1) 
DX = network address 
ES = TurboDOS base address (paragraph) 



Explanation 



The Return Version function provides informa- 
tion on the latest compatible version of 
CP/M. (The BDOS version number returned in 
register BL may be changed by patching the 
symbol CPMVER during system generation.) 

This function also returns a network address 
in register DX. This address is obtained 
from the first entry of the circuit assign- 
ment table (CKTAST). It may be used wherever 
a unique processor or console identification 
is required. 

Finally, the function returns the base para- 
graph address of the resident TurboDOS opera- 
ting system in register ES. 
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Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

C-Function 13 Reset Disk System 

Entry Arguments I Reg | r Description 

I 

I CL = 13 



Explanation In TurboDOS, the only effect of the Reset 

Disk System function is to reset the current 
DMA offset to 0x0080. (See C-function 26, 
Set DMA Offset.) 
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C-Function 14 
Select Disk 



Copyright 1984 by Software 2000, Inc, 
All rights reserved. 



C-Function 14 






Select Disk 






CL 
DL 



= 14 



selected disk drive 

for drive A 

1 for drive B 

15 for drive P 



Explanation 



The Select Disk function causes the disk 
drive specified in register DL to be selected 
as the current (default) disk drive. The 
current drive is used in subsequent file 
operations whenever the FCB drive field is 
set to zero. 
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C-FDNCTIONS 

C-Function 15 
Open File 
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All rights reserved. 



C-Function 15 

Entry Arguments 



Open File 

I Re g j 



J2£J5JGlip£il2B I 



I CL = 15 

I DS:DX = FCB address 



_l 



Returned Value 



I -JBSS—L.™; , P&gJCXipii^n 



Explanation 



AL = if successful 

-1 if file not found 



The Open File function opens the file speci- 
fied by the FCB drive, name, type, and extent 
fields (bytes through 12). Normally, the 
extent field (byte 12) should be set to zero. 
The specified file must exist under the cur- 
rent user number or must be a global file 
under user 0. 

The open mode is determined by compatibility 
flag bit 7 (permissive) and by the FCB inter- 
face attributes f5 and f6, as shown in the 
following table: 



pejcmlsjsiy^j 
^3E6.<flL^Lapen, mofo 





1 

1 
1 1 



exclusive 
shared 
read-only 
read-only 



i§ f5 1 open mpfle 

permissive 

1 shared 

1 read-only 
1 1 exclusive 



If the FCB current record field (byte 32) is 
set to -1, this function returns the byte 
count of the last record of the file in the 
current record field. The calling program 
should zero the current record field before 
doing sequential reads or writes. 
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C-Function 16 
Close File 
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C-Function 16 

Entry Arguments 



Close File 



i fieg j 



?ffPIAPtJ-PPn 



i 



CL = 16 

DS:DX = FCB address 



Returned Value 



I J&SJELi w ^Pej^rjj?£ipj) 

I 

! AL a o if successful 

I -1 if file not found 



Explanation 



The Close File function closes a file pre- 
viously opened by an Open File (15) or Make 
File (22) C-function. The directory is up- 
dated if necessary to reflect any new blocks 
allocated to the file, and any locked records 
are unlocked. 



TF T?r*U i nfor Fa r»< 



a4-+-riHn+-c» F ^ ic q^ +- 



h\\ i a 



function performs a "partial close" operation 
which updates the directory but leaves the 
file open. 
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C-FUNCTIONS 

C-Function 17 
Search for First 
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C-Function 17 

Entry Arguments 



Search for First 

I Reg | 3eJ5£JEip£i£B I 

I I 



CL = 17 

DS:DX = FCB address 



_l 



Returned Value 



LB£S~-L— JBfi5£xipJfei£n 

I 

I AL = entry nUim ^ er (q-3) if successful 

I -1 if file not found 



Explanation 



The Search for First function scans the 
directory for the first entry which matches 
the FCB drive, name, type, and extent fields 
(bytes through 12) and the current user 
number. An ASCII question mark (0x3F) in any 
FCB byte 1 through 12 is treated as a wild- 
card which matches any character in the cor- 
responding byte position of the directory 
entry. 

If the search is successful, this function 
returns a directory record (containing four 
32-byte directory entries) at the current DMA 
address, and a value in register AL (0-3) 
that indicates which of the four entries was 
found to match the FCB. If the search is not 
successful, the function returns -1 (OxFF) in 
register AL. 

If the Search for First function succeeds in 
finding an entry which matches the given FCB, 
then C-function 18 (Search for Next) may be 
called repeatedly to locate all remaining 
matches in the directory. 
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Search for First 

(Continued) 

Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

Explanation A special situation occurs if the FCB drive 

(Continued) field (byte 0) is set to a question mark 

^uaji;/. J.H uiixo K^aotSf uuc Lciaaa-uuci ui unc 

FCB is ignored, the directory of the current 
drive is searched, and the Search for First 
function returns the very first directory 
entry (usually the volume label). The Search 
for Next function will then return each suc- 
cessive directory entry in sequence, regard- 
less of user number. Even deleted entries 
are returned in this case. 
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C-FDHCTIONS 

C-Function 18 
Search for Next 
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C-Function 18 

Entry Arguments 



Returned Value 



Explanation 



Search for Next 

1 „ Req.J. P^Sxiitisn I 

l l 

l cl - 18 l 

l ^ _ : , I 

1 Reg 1 P£sjcjcipJtiJ2D I 

I I 

I AL = entry number (0-3) if .successful I 
I -1 if file not found I 

I I 

The Search for Next function continues the 
search initiated by C-function 17 (Search for 
First). If the search is successful, this 
function returns a directory record (contain- 
ing four 32-byte directory entries) at the 
current DMA address, and with a value in 
register AL (0-3) that indicates which of the 
four entries was found to match the FCB. If 
the search is not successful, the function 
returns -1 (OxFF) in register AL. 
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C-Function 19 
Delete File 
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C-Function 19 



riiitiy fmyUmeirta 



Returned Value 



Delete File 



i feeq I 



,*J£S>±f±A±>JkrU,UU- 



I CL - 19 

I DS:DX = FCB address 



L&ea~L__ •. BeggslptiQiL- 



AL = if successful 

-1 if no file was deleted 



Explanation 



The Delete File function deletes the file 
specified by the FCB drive, name, and type 
fields (bytes through 11) and the current 
user number. ASCII question marks (0x3F) may 
be used as wild-cards anywhere in the FCB 
name and type fields, in which case this 
function deletes all matching files. 

A program may delete a file that it has open, 
in which case a close is performed implicitly 
before the file is deleted. However, a pro- 
gram is not permitted to delete a file that 
another process has open, nor a file that has 
the read-only or FIFO attributes. 

If FCB interface attribute f5 is set, this 
function performs no operation and returns 
AL=0 to indicate successful completion. 
(This is for compatibility with M/PM and 
Concurrent CP/M, where the f5 attribute 
causes only XFCBs to be deleted.) 
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C-FDNCTIONS 

C-Function 20 
Read Sequential 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Punction 20 

Entry Arguments 



Read Sequential 

I ., Reg^i Z JbsssxisXiQn^. 

I 

I cl = 20 

I DS:DX = FCB address 



Returned Value 



Explanation 



I fieg, J t P£5i 

I I 

1 AL = if successful I 

I 1 if at end-of-file I 

I 128 if FCB current record invalid I 
I I 

The Read Sequential function reads the next 
one or more 128-byte records from a file into 
memory starting at the current DMA address. 
The number of records to be read (up to 128) 
is determined by C-function 44 (Set Multi- 
Sector Count). The default is one record. 

The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func- 
tion, and the FCB current record field (byte 
32) initialized to zero. 

This function uses the FCB extent and current 
record fields to determine the record to be 
read, then increments the current record 
field in preparation for the next sequential 
operation. If the current record field over- 
flows, the next extent is opened and the 
current record field is reset to zero. 

If the file being read is a FIFO, records are 
read from the beginning and removed from the 
FIFO. Reading an empty FIFO either suspends 
or returns end-of-file (AL=1) depending upon 
the mode byte in the FIFO header. However, 
if FCB interface attribute f5 is set, reading 
an empty FIFO always returns end-of-file. 
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C-Function 21 
Write Sequential 
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C-Function 21 






Returned Value 



Explanation 



Write Sequential 



i , fts s-i — . p£££xip£i.QJi. 



CL = 21 

DS:DX = FCB address 



JRfiflL.L„, ■. wE£££fi£Jti£DL 



AL = if successful 

1 if file too large (>134 Mb) 

2 if disk full or file read-only 

8 if attempt to write locked record 
128 if FCB current record invalid 
-1 if no directory space 



The Write Sequential function writes the next 
one or more 128-byte records of a file from 
memory starting at the current DMA address. 
The number of records to be written (up to 
128) is determined by C— function 44 (Set 
Multi-Sector Count). The default is one. 

The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func- 
tion, and the FCB current record field (byte 
32) initialized to zero. This function uses 
the FCB extent and current record fields to 
determine the record to be write, then incre- 
ments the current record field in preparation 
for the next sequential operation. If the 
current record field overflows, the next 
extent is opened (or created if it does not 
exist) and the current record is zeroed. 

If the file being written is a FIFO, records 
are appended to the end. Writing a full FIFO 
either suspends or returns disk-full (AL=2) 
depending on the FIFO header mode byte. How- 
ever, if FCB interface attribute f5 is set, 
writing a full FIFO always returns disk-full. 
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C-Punction 22 
Make Pile 
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C-Punction 22 

Entry Arguments 



Returned Value 



Make Pile 

I Reg i Pejg cjripjti six. 



CL = 22 

DS:DX = FCB address 



I ~ftsa.-L w Pe^JSxipJtifiiL.. 

I 



AL = if successful 

-1 if directory full, file exists, 
or FCB invalid 



Explanation 



The Make File function creates a new (empty) 
file specified by the FCB drive, name, type, 
and extent fields (bytes through 12). Nor- 
mally, the extent field (byte 12) should be 
set to zero. The directory entry for the new 
file is placed under the current user number. 
All file attributes are initialized to zero. 
A request to make a file that already exists 
is denied. 

The newly-created file is left in an open 
state. If the FCB interface attribute f5 is 
set, then the file is left open in shared 
mode. Otherwise, the file is left open in 
either exclusive or permissive mode, depend- 
ing on compatibility flag bit 7 (permissive). 

The calling program should zero the FCB cur- 
rent record field (byte 32) before doing 
sequential reads or writes on the file. 
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C-Function 23 
Rename File 
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C-Function 23 

Entry Arguments 



Returned Value 



Rename File 

i Reg i^I-.IZ^IIIIIII5iiBHpxiB5, 



CL ■ 23 

DS:DX « FCB address 



I Jfifl^L- ■-PfiftCIJBfciflJPu- 



AL = if successful 

-1 if file not found, file in-use, 
or file name invalid 



Explanation 



The Rename File function renames the file 
specified by the FCB drive, name, and type 
fields (bytes through 11) and the current 
user number. The file is given the new name 
and type specified in bytes 17 through 27 of 
the FCB. Wild-card characters (ASCII ques- 

L1UU 1UC11.IVOS alC 11VI. « J. J. V W C »-* Xlt cn.uct UUC WXU 

or new name. All remaining bytes of the FCB 
are disregarded by this function. 

A program may rename a file that it has open, 
in which case a close is performed implicitly 
before the file is renamed. However, a pro- 
gram is not permitted to rename a file that 
another process has open, nor a file that has 
the read-only attribute. 
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C-Function 24 
Return Login Vector 
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C-Function 24 

Entry Arguments 



Return Login Vector 

l Reg^IIZIZIIIIIIIIpiiiHiliBB- 

l 

l cl = 24 



Returned Value 



Explanation 



I Reg I 
I 



_E£££J^J2ki£IL 



I BX = login vector 



The Return Login Vector function tests the 
ready status of all disk drives. It returns 
a 16-bit vector in register BX containing a 
one-bit for each drive that is ready for 
access, and a zero-bit for each drive that is 
not ready or not defined. The least signifi- 
cant bit corresponds to drive A, and the most 
significant bit to drive P. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 25 
Return Current Disk 
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C-Function 25 






Return Current Disk 






CL = 25 



Returned Value 



I , Rett-J— Ssssxistisn. 



AL = current disk drive: 

for drive A 

1 for drive B 



Explanation 



15 for drive P 



The Return Current Disk function returns the 
identity of the current (default) disk drive 
in register AL. 
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C-Function 26 
Set DMA Offset 
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C-Punction 26 

Entry Arguments 



Explanation 



Set DMA Offset 

Reg .A-JUZJH DsssxistlQXL 



CL - 26 

DX = DMA offset address 



The Set DMA Offset function causes the offset 
address specified in register DX to be used 
as the record buffer address for subsequent 
file rea'd" and Write operations. The DMA 
offset is relative to the current DMA base 
(see C-f unction 51). 

Whenever a program is loaded into the TPA, 
the DMA base is initialized to the data seg- 
ment base of the program. The DMA offset is 
initialized to 0x0080, the address of the 
default record buffer in the Base Page. C- 
function 13 (Reset Disk System) also sets the 
DMA offset to 0x0080. 
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C-Punction 27 
Get ALV Address 
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C-Punction 27 



"*»«-*.jf srxi. vjUJtllCllUO 



Get ALV Address 



i pt?y| J 



I CL - 27 



Bsj&jJL&^Asji 



Returned Value 




P£J5£jipJfc±QJ3 



Explanation 



This function performs no operation in Turbo- 
DOS. (Under CP/M, it returns the address of 
the memory-resident allocation vector for the 
current disk.) 
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C-Function 28 
Write Protect Disk 
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C-Function 28 

Entry Arguments 

Explanation 



Write Protect Disk 

I Reg J Z Si£xiiII5oII ZZL I 

I I 

I cl = 28 I 

The Write Protect Disk function marks the 
current (default) disk drive as read-only, 
preventing any program from writing to the 
d i s k . C-.fun.cti on 37 (Reset. D rive) must be. 
used to enable writes to the disk once again. 

Unlike CP/M, TurboDOS does not re-enable 
writing after warm-start, C-function (Sys- 
tem Reset), or C-function 13 (Reset Disk 
System). Consequently, write-protection of a 
disk drive is not nearly so temporary as it 
is .in CP/M. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 29 
Get Read-Only Vector 
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C-Function 29 

Entry Arguments 



Get Read-Only Vector 

i . Reg j JDej^lipilQB — 

I 

I CL = 29 
i 



Returned Value 



Explanation 



I, Beg J BssszistisxL 

l 

I BX = read-only vector 



The Get Read-Only Vector function returns a 
16-bit vector in register BX containing a 
one-bit for each disk drive that is write- 
protected, and a zero-bit for each drive that 
is not. The least significant bit corres- 
ponds to drive A, and the most significant 
bit to drive P. 

NOTE: This function is supported only if the 

U^UJ. VllSj. 1UVUUXC Vil nUUli XU .».i*w.i_w»x->,'*« ■»«»»»* »»^j 

TurboDOS system generation. 
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C-FDNCTIONS 

C-Function 30 
Set File Attributes 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 30 

Entry Arguments 



Set File Attributes 

I Reg i £ij5£jcipli551 

I 

I CL = 30 

I DS:DX - FCB address 



I 



Returned Value 



I -.&3S-. J-^ w Pe^cxLBfcJJML 



I AL = if successful 

I -1 if file not found or in-use 



Explanation 



The Set File Attributes function searches the 
directory for the file specified by the FCB 
drive, name, and type fields (bytes through 
11). and the current user number, and updates 
the file attributes in the directory from 
those in the FCB. (File attributes are 
stored in the high-order bit of FCB bytes 1-4 
and 9-11.) 

In addition, if FCB interface attribute f6 is 
set, this function updates the last record 
byte count of the file. The count is ob- 
tained from the current record field (byte 
32) of the FCB, and stored in the sped field 
(byte 13) of each directory entry. 

A program may set attributes on a file that 
it has open, in which case a close is per- 
formed implicitly before the attributes are 
set. However, a program is not permitted to 
set attributes on a file that another process 
has open. 
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C-PUNCTIONS 

C-Function 31 
Get DPB Address 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Punction 31 






Get DPB Address 




Returned Value 



Reg J P£j5£JCipiiPB- 

ES:BX = DPB address 



Explanation 



The Get DPB Address function causes TurboDOS 
to construct a CP/M-style Disk Parameter 
Block (DPB) for the current drive, and to 
return its memory address in ES:BX. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-FUNCTIONS 

C-Function 32 
Get/Set User Number 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 32 

Entry Arguments 



Get/Set User Number 

I Reg lJIlZZS~~~JlZh£3£xiE£ism- 



L. 



CL 
DL 



- 32 



-1 to get user number 
0-31 to set user number 



Re t u r ne d Va 1 ue 



Explanation 



_JQ£JS£lipJkiiM> : 



1 Reg I , 

I 

I AL = user number 0-31 (if get) 



The Get/Set User Number function can be used 
either to set or to return the current user 
number. If the value -1 (OxFF) is passed in 
register DL, this function returns the cur- 
rent user number in register AL. If some 
other value is passed in register DL and if 
the caller is a privileged log-on, this func- 
tion sets the current user number to the 
specified value (modulo 32). A request to 
set the current user number from a non-privi- 
leged log-on is ignored. 
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C-FUNCTIONS 

C-Function 33 
Read Random 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 33 



Read Random 



juiii.ua. j m.vjuuiciii.0 



I Rey { _ JBe^^xi^iivB 

I 

I CL = 33 

I DS:DX = FCB address 



Returned Value 



iJ&eaJ -.JD£Ji£xipiioiL„ 

I 

I AL = if successful 

I 1 if reading unwritten data 

I 3 if error changing extents 

I 4 if reading unwritten extent 

I 6 if random record number invalid 



Explanation 



The Read Random function reads one or more 
consecutive 128-byte records from a file into 
memory starting at the current DMA address. 
The number of records to be read (up to 128) 
is determined by C-function 44 (Set Multi- 
Sector Count). The default is one record. 

The first record to be read is specified by a 
20-bit random record number obtained from the 
FCB random record field (bytes 33 through 
35). The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func- 
tion. 

This function sets the FCB extent and current 
record fields to correspond with the record 
that was read. Unlike C-function 20 (Read 
Sequential), however, it does not increment 
the current record field after reading. 
Thus, if the Read Random function is followed 
by a Read Sequential or Write Sequential, the 
same record is re-accessed. 
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C-FDNCTIONS 

C-Function 34 
Write Random 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 34 

Entry Arguments 



Write Random 

1 Reg i^-ZIIZZIII->3iSji5iBi- 



cl = 34 

DS:DX = FCB address 



Returned Value 



Explanation 



l-J&fiflL- 



AL = 



LSILw. 



if successful 

if disk full or write-protected 

if error changing extents 

if no directory space 

if random record number invalid 



8 if writing locked record 



The Write Random function writes one or more 
consecutive 128-byte records of a file from 
memory starting at the current DMA address. 
The number of records to be written (up to 
128) is determined by C-function 44 (Set 
Multi-Sector Count). The default is one 
record. 

The first record to be written is specified 
by a 20-bit random record number obtained 
from the FCB random record field (bytes 33 
through 35). The given FCB must have been 
previously opened by an Open (15) or Make 
(22) C-function. 

This function sets the FCB extent and current 
record fields to correspond with the record 
that was written. Unlike C-function 21 
(Write Sequential), however, it does not 
increment the current record field after 
writing. Thus, if the Write Random function 
is followed by a Read Sequential or Write 
Sequential, the same record is re-accessed. 
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C-PUHCTIONS 

C-Function 35 
Compute File Size 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 35 






Compute File Size 



I CL = 35 

! DS:DX = FCB address 



._ I 



Returned Value 



Explanation 




The Compute File Size function searches the 
directory for the file specified by the FCB 
drive, name, and type fields (bytes through 
11).. If the file is found, this function 
sets the FCB random record field (bytes 33 
through 35) to a value one greater than the 
record number of the last record in the file. 
Thus, a succeeding Write Random function (34) 
will append an additional record at the end 
of the file. 

In TurboDOS, the Compute File Size function 
returns the correct result whether the file 
is open or closed. 
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C-FUNCTIONS 

C-Punction 36 
Set Random Record 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

C-Function 36 Set Random Record 



Entry Arguments 



. Reg-1„ JtefifxiPtLfiD 



CL - 36 

DS:DX = FCB address 



Explanation 



The Set Random Record function returns the 
current file position of an open file in the 
random record field --(bytes 33-35) of the FCB. 
(The file position is determined from the 
values of the FCB extent, spec2, and current 
record fields.) Since the Read Sequential 
(20) and Write Sequential (21) functions do 
not update the random record field of the 
FCB, this function is useful when switching 
from sequential to random access. 
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C-FUNCTIONS 

C-Punction 37 
Reset Drive 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 37 



. jr n*. y unic nus 



Explanation 



Reset Drive 

l 

I CL - 37 

I DX = reset vector 



The Reset Drive function write-enables the 
disk drives specified by the 16-bit reset 
vector passed in register DX. The reset 
vector contains a one-bit for each disk drive 
that is to be write-enabled, and a zero-bit 
for each drive that is not. The least signi- 
ficant bit corresponds to drive A, and the 
most significant bit to drive P. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-FUHCTIONS 

C-Punction 40 
Write Random 0-Fill 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 40 

Entry Arguments 



Write Random with Zero Fill 

I 

I CL - 40 

I DS:DX = FCB address 



Returned Value 



Explanation 



J 



I .Reg, J , Pejacji^tipii 

AL = if successful 

2 if disk full or write-protected 

3 if error changing extents 

5 if no directory space 

6 if random record number invalid 
8 if writing locked record 



The Write Random with Zero Fill function is 
implemented in TurboDOS as a synonym for 
Write Random (C-f unction 34) . 
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C-FUNCTIONS 

C-Punction 42 
Lock Record 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 42 



entry Arguments 



Returned Value 



Explanation 



Lock Record 

Reg j 



J&£££L£ti£B 



CL = 42 

DS:DX = FCB address 



~££S_Jw fi.escj;j.p.tj.on„. u ^ .. 

AL = if successful 

1 if positioning to unwritten data 

3 if error changing extents 

4 if positioning to missing extent 
6 if random record number invalid 
8 if locked by another process 



The Lock Record function attempts to obtain a 
lock on one or more consecutive records, 
starting with the 20-bit random record number 
obtained from FCB random record field (bytes 

"3 "i Hlf/MlrtV\ QE\ fUVtn niimKnv /vf y *+. it ^v w <3 r» 1 ss st Ir «n s3 

<3«> W1IJ. VU^H 0-~f/» J. 11C liUlUWCl UJ. Lcvv/luo 1VUIVCU 

(up to 128) is determined by C-function 44 
(Set Multi-Sector Count). The default is one 
record. The given FCB must have been pre- 
viously opened in shared mode. If the file 
is not open in shared mode, this function 
performs no operation and returns AL=0. 

The file is positioned to the specified 
record, unless compatibility flag bit 3 
(logical) is set or the file is a FIFO. If 
the record is already locked by another 
process, this function either suspends or 
returns an error (AL=8) depending on the set- 
ting of compatibility flag bit 6 (suspend). 

If the FCB random record field is set to the 
24-bit value OxFFFFFF, then this function 
attempts to obtain an all-inclusive lock (on 
all records of the file at once). In this 
case, no positioning is performed. 
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C-FUNCTIONS 

C-Function 43 
Unlock Record 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 43 

Entry Arguments 



Unlock Record 

I , Reg jJZZI"IZZIPje^JgnpIIS j 

l l 

l cl = 43 l 

I DS:DX = FCB address I 



Returned Value 



I J3,fifiLJw-w--w w^JteJ^jOPJt JJML. w-w. 



Explanation 



I 



AL = 



if successful I 

if positioning to unwritten data I 

if error changing extents I 

if positioning to missing extent I 

if random record number invalid I 



The Unlock Record function unlocks one or 
more consecutive records, starting with the 
20-bit random record number obtained from FCB 
random record field (bytes 33 through 35). 
The number of records unlocked (up to 128) is 
determined by C-function 44 (Set Multi-Sector 
Count). The default is one record. Attempt- 
ing to unlock a record which was not pre- 
viously locked does not return an error. The 
given FCB must have been previously opened in 
shared mode. If the file is not open in 
shared mode, this function performs no opera- 
tion and returns a successful result. 

The file is positioned to the specified 
record, unless compatibility flag bit 3 
(logical) is set or the file is a FIFO. 

If the FCB random record field is set to the 
24-bit value OxFFFFFF, then this function 
releases any all-inclusive lock on the file, 
but does not affect any individual record 
locks. In this case, no positioning is per- 
formed. 
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C-FUNCTIONS 

C-Function 44 
Set Multi-Sector Cnt 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 44 

Entry Arguments 



Returned Value 



Explanation 



Set Multi-Sector Count 

i „ Reg lJZZZZZ~ I ISiBIIpiiB^-.. 

I 

I cl = 44 

i DL = number of records (1-128) 



,££S^.Lw 

AL = 



^~~vP£££JCip£iiMi~ 



The Set Multi-Sector Count function enables a 
program to read or write up to 128 records at 
a time during subsequent file operations. 
This function affects subsequent calls to the 
following C-f unctions: 



„ CrFJjncJEjoj^l PfiAgxipJticjx 



21 
33 
34 
42 
43 



Read Sequential 
Write Sequential 
Read Random 
Write Random 
Lock Record 
Unlock Record 



and establishes the number of consecutive 
128-byte records to be read, written, locked 
or unlocked. Once set, the specified record 
count remains in effect until changed by 
another Set Multi-Sector Count C-function. 
The initial default value is one record. 
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C-FUNCTIONS 

C-Function 46 
Get Disk Free Space 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 46 

Entry Arguments 



Get Disk Free Space 



I .. Reg ,. I. 



^■BeJSjgJEip.tiop l 



cl = 46 

DL = disk drive: 

for drive A 

1 for drive B 

15 for drive P 



Returned Value 



Explanation 



LBftELJ— -w-_ 



?££££ 



AL = 




The Get Disk Free Space function determines 
the amount of free space on the specified 
disk drive. It returns a 24-bit binary value 
(the number of free 128-byte records) as a 
three byte quantity stored at the current DMA 
address, least significant byte first. 
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C-PUNCTIONS 

C-Function 47 
Chain to Program 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 47 

Entry Arguments 



Chain to Program 

1 ,Reg, J Z11—11Z P£5£xipiiPDi 



CL 
DL 



= 47 



to revert to original disk/user 
-1 to retain current disk/user 



Explanation 



The Chain to Program function provides a 
means of chaining from one program to 
another. The calling program must place a 
valid TurboDOS command line, terminated by a 
null byte, in the Base Page record buffer 
starting at location 0x0080. This function 
terminates the calling program, and then 
executes the command line. The commands are 
echoed to the console as they are executed, 
unless the command line starts with a command 
separator (backslant) character. 

If DL = 0, the current disk and current user 
number reverts to what it was when the 
calling program was originally loaded into 
the TPA (the normal warm-start procedure). 
If DL = -1, however, the current disk and 
current user number at the time of call is 
retained. 
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C-FUNCTIONS 

C-Function 50 
Direct BIOS Call 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 50 

Entry Arguments 



Direct BIOS Call 

I. Beg, J ~ Pfi^cxij&isjx- 



I CL = 50 

I DS:DX = BIOS Parameter Block address 

I 



Returned Value 



Explanation 




.fifcSCJCipJfcilMU _w~ ■ — . I 



BX = BIOS return value 



The Direct BIOS Call function simulates a 
direct call to a CP/M BIOS routine. This 
function is called with the address of a BIOS 
Parameter Block in DS:DX. The BIOS Parameter 
Block is five bytes long, and has the 
following structure: 



Qffset 



1-2 

3-4 



,D£&QlipJti£B_. 



BIOS function number 
CX-register entry value 
DX-register entry value 



Under TurboDOS, such BIOS functions calls are 
emulated by converting them to an equivalent 
C-function call. Consequently, there is no 
performance advantage in using the Direct 
BIOS Call function, and its use is not en- 
couraged. 

The table on the next page describes the 
various simulated BIOS functions which may be 
invoked via the Direct BIOS Call function. 
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C-FUNCTIONS 

C-Function 50 

Direct BIOS Call 

(Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Explanation 



I BIOS I 






I Equiv I 

I n — Pz-it-l I 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

.15 

16 

17 

18 

19 

20 



Cold start 

Warm start 

Console status to AL 

Raw console input to AL 

Raw console output from CL 

List output from CL 

Raw console output from CL 

Raw console input to AL 

Set track to zero 

Select disk drive from CL 

Set track number from CX 

Set sector number from CX 

Set DMA offset from CX 

Read disk sector ($.DSK) 

Write disk sector ($.DSK) 

List status to AL (always -1) 

Sector translate CX into BX 

Set DMA base from CX 

MEMTBL offset to BX 

Get I0BYTE to AL 

Set IOBYTE from CL 





11 

3 

4 

5 
4 
3 

14 



26 
33 
34 



51 

7 
8 
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C-FUNCTIONS 

C-Function 51 
Set DMA Base 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 51 

Entry Arguments 



Set DMA Base 



Esssxi&ism 



CL = 51 

DX = DMA base (paragraph address) 




Explanation 



The Set DMA Base function causes the para- 
graph address specified in register DX to be 
used in conjunction with the current DMA 
offset as the record buffer address for sub- 
sequent read and write operations. (See C- 
function 26, Set DMA Offset.) 

Whenever a program is loaded into the TPA, 
the DMA base is initialized to the initial 
data segment base. 
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C-PONCTIONS 

C-Punction 52 
Return DMA Address 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Punction 52 

Entry Arguments 



Return DMA Address 



,-* • 



i .Beg.i p£ jj^i^tiPB 

I i 

I CL = 52 I 



Returned Value 



I Reg, ,1 



£s$£xl£&iszn 



BX = current DMA offset 
ES = current DMA base 



Explanation 



The Return DMA Address function returns the 
current DMA base (paragraph address) in ES 
and the current DMA offset (byte address) in 
BX. 



4-51 



TurboDOS 1.4 8086 
Programmer's Guide 



C-FUNCTIONS 

C-Punction 53 
Alloc Max Memory 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 53 

Entry Arguments 



Allocate Maximum Memory 

I _Iis_i w Jill JSiHpHiax.. 



CL » 53 

DS:DX = MCB address 



Returned Value 



Explanation 



I Reg I . . JBfiJSjexipiifiB- 



I AL = if successful 

I -1 if no memory was available 



The location of a Memory Control Block (MCB) 
is passed in DS:DX. The MCB is five bytes 
long and has the following structure: 

l_&E£S£i-J Be^JSXipJiflB 



0-1 
2-3 
4 



MCB-Base (paragraph address) 
MCB-Length (in paragraphs) 
MCB-Ext (byte value) 






The Allocate Maximum Memory function allo- 
cates the largest available memory region of 
size less than or equal to the number of 
paragraphs specified by MCB-Length. If suc- 
cessful, the base address and length of the 
allocated region are returned in MCB-Base and 
MCB-Length, and MCB-Ext is set to 1. 
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C-FOHCTIONS 

C-Function 54 
Alloc Abs Max Memory 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 






C-Function 54 

Entry Arguments 



Returned Value 



Allocate Absolute Maximum Memory 



CL = 54 

DS:DX = MCB address 



I Reg, 1 



P&acjupiioja 



AL = if successful 

-1 if no memory was available 



Explanation 



The location of a Memory Control Block (MCB) 
is passed in DS:DX. The MCB is five bytes 
long and has the following structure: 



I 

I 0-1 

i 2-3 

I 4 



MCB-Base (paragraph address) 
MCB-Length (in paragraphs) 
MCB-Ext (byte value) 



The Allocate Absolute Maximum Memory function 
allocates the largest available memory region 
starting at the absolute paragraph address 
specified by MCB-Base and of size less than 
or equal to the number of paragraphs speci- 
fied by MCB-Length. If successful, the 
length of the allocated region is returned in 
MCB-Length. 
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C-FONCTIONS 

C-Punction 55 
Allocate Memory 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 55 

Entry Arguments 



Allocate Memory 

i.fteg.i PejeJIipUBxC. 

I cl - 55 

I DS:DX = MCB address 



Returned Value 



L&es~L-~-^ t J2£SJ5*ipii£J3w~ 

I 

I AL = if successful 

I -1 if memory was not available 



Explanation 



The location of a Memory Control Block (MCB) 
is passed in DS:DX. The MCB is five bytes 
long and has the following structure: 



0-1 
2-3 
4 



MCB-Base (paragraph address) 
MCB-Length (in paragraphs) 
MCB-Ext (byte value) 



The Allocate Memory function attempts to 
allocate a memory region of the size speci- 
fied by MCB-Length. If successful, the base 
address of the allocated region is returned 
in MCB-Base. 
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C-FUNCTIONS 

C-Function 56 
Alloc Abs Memory 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 56 

Entry Arguments 



Returned Value 



Explanation 



Allocate Absolute Memory 

I 

I CL = 56 

I DS:DX = MCB address 

I^W.. ; _ w-w w , 

I ..-gfifl-JL^ DsSSlJLstiQQ-. 



AL = if successful 

-1 if memory was not available 



The location of a Memory Control Block (MCB) 
is passed in DS:DX. The MCB is five bytes 
long and has the following structure: 



I ,QffseJ;.J. Pes cjeipjti on. 



0-1 MCB-Base (paragraph address) 
2-3 MCB-Length (in paragraphs) 
4 MCB-Ext (byte value) 



The Allocate Absolute Memory function at- 
tempts to allocate a memory region starting 
at the absolute paragraph address specified 
by MCB-BASE and of the size specified by MCB- 
Length. 
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C-FUHCTIONS 

C-Function 57 
Free Memory 



Copyright 1984 by Software 2000, Inc. 
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C-Function 57 

Entry Arguments 



Free Memory 

I .. Reg^illlZIIIZIIIIIpiiSxIStiBS 



cl - 57 

DS:DX = MCB address 



I- 



Returned Value 



Explanation 



l-,Bfi5^i^____^^^J3fi&CXiPtii2J5- 



AL 



if successful 

-1 if invalid request 



The location of a Memory Control Block (MCB) 
is passed in DS:DX. The MCB is five bytes 
long and has the following structure: 



JMJEfifiJLJ-w. 



JSSSSZiStiQIL. 



0-1 MCB-Base (paragraph address) 
2-3 MCB-Length (in paragraphs) 
4 MCB-Ext (byte value) 



The Free Memory function is used to deallo- 
cate memory regions previously allocated by 
the calling program. If MCB-Ext is passed as 
-1, then all memory allocated by the calling 
program and its descendants is deallocated. 
If MCB-Ext is passed as 0, then just the 
region defined by MCB-Base and MCB-Length is 
deallocated. In the latter case, the speci- 
fied region must be space previouly allocated 
by the calling program. 
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C-Punction 58 
Free All Memory 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 

C-Function 58 Free All Memory 

Entry Arguments I Reg JIIZ^I~IIIIlpiii5pnB5ZIIZIIIIZIIII I 

I I 

I CL = 58 I 

I ^^^^^ ,^_ ,,,.. ..,,,..,.,.,., ,.., ., , I 

Explanation The Free All Memory function deallocates all 

previously allocated memory regions, regard- 
less of who allocated them. 

TurboDOS automatically performs this function 
at each program termination (warm-start), so 
it is almost never necessary for a program to 
call this function explicitly. 
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C-FUNCTIONS 

C-Function 59 
Program Load 



Copyright 1984 by Software 2000 , Inc. 
All rights reserved. 



C-Function 59 

Entry Arguments 



Returned Value 



Program Load 



1 Reg I 



B£££Jti£&ifiIL~ 



CL = 59 

DS:DX = FCB address 



JRfiSUL 



jscjtipJtisa. — — w 



BX = Base Page paragraph address 

or OxFFFF if unsuccessful 



Explanation 



The Program Load function loads the .CMD file 
specified by the FCB into the TPA. Memory 
regions are automatically allocated for each 
segment group as specified by the .CMD header 
record, and code or data is loaded as re- 
quired into the allocated regions from the 
body of the .CMD file. Performance of this 
function is optimized through the use of 
multi-sector operations. 

Note that this function does not affect the 
current DMA base or offset addresses. 
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C-Funetion 104 
Set Date and Time 



Copyright 1984 by Software 2000 , Inc, 
All rights reserved. 



C-Punction 104 

Entry Arguments 



Set Date and Time 

LReg.i^ ^ BsssxisXisn 

CL ■ 104 

DS:DX a date/time packet address 



Explanation 



The Set Date and Time function sets the 
system date and time. The address of a four- 
byte date/time packet is passed in DS:DX. 
The date/time packet has the following struc- 
ture: 

I . Of ts^JlJlZSZZ^Jb2shxisB,Qn . . 

0-1 Date, represented as a 16-bit 

Julian date with zero correspon- 
dign to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi- 
nary coded decimal (BCD) digits 



Seconds are set to zero. 
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C-F0NCTIONS 

C-Function 105 
Get Date and Tine 



Copyright 1984 by Software 2000, Inc. 
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C-Function 105 Get Date and Time 

Entry Arguments lISEIEZIZIZZIIIZISiSiiSBB- 



I CL = 105 

I DS:DX = date/time packet address 

I 



»J 



Returned Value 



Explanation 



,.^£££Xi£ti£IL 
AL = seconds (two BCD digits) 



The Get Date and Time function returns the 
system date and time in a four-byte date/time 
packet whose address is passed in DS:DX. The 
date/time packet has the following structure: 

ZoS&sEj. I™l-_P££CxiPJti£D-. w. 



0-1 Date, represented as a 16-bit 

Julian date with zero correspon- 
ding to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi- 
nary coded decimal (BCD) digits 



Seconds are returned in register AL, repre- 
sented as two binary coded decimal (BCD) 
digits. 
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C-Function 107 
Return Serial Number 



Copyright 1984 by Software 2000, Inc. 
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C-Function 107 

Entry Arguments 



Return Serial Number 



! . B eg.. J J?£5jpjcipJti£J& -. 

CL - 107 

DS:DX = address of 6-byte S/N field 



Explanation 



The Return Serial Number function returns the 
CP/M serial number in the 6-byte field whose 
address is passed in DS:DX. Under TurboDOS, 
this function always returns six zero bytes. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 108 
Get/Set Return Code 
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C-Function 108 

Entry Arguments 



Get/Set Program Return Code 

L^ZJZZZZZZZ^ZZZZZ^s^I^Xsm^ — , 
I 

I CL = 108 

I DX = OxFFFF (if get) 

I program return code (if set) 






Returned Value 



Explanation 



I J 

I BX » program return code (if get) I 



The Get/Set Program Return Code function 
provides a means for one program to pass a 
16-bit value to another program. For ex- 
ample, this function can be used to advantage 
in connection with C-function 47 (Chain to 
Program) . 

If register DX is set to OxFFFF, then this 
function interrogates the program return code 
and returns it in register BX. Otherwise, 
this function sets the program return code to 
the value passed in register DX. 
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C-Function 110 
Get/ Set Delimiter 
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C-Function 110 

Entry Arguments 



Get/ Set Program Output Delimiter 



,J3&g_J_.^.^ ^Bsssxi&isw^*^ 

CL - 110 

DX = OxFPFF (if get) , or 

DL = output delimiter (if set) 



Returned Value 



Explanation 



I ugeg. u . j, L .. . , u . IL . Vu . u . L <,Pei 

I 

I AL = output delimiter (if get) 



The Get/Set Output Delimiter function can be 
used to set or interrogate the output delimi- 
ter used by C-function 9 (Print String). 
Whenever a program is loaded into the TPA, 
the output delimiter is initialized to the 
dollar sign $ character. 

If register DX is set to OxFFFF, then this 
function interrogates the current output 
delimiter and returns it in register AL. 
Otherwise, this function sets the output 
delimiter to the value passed in register DL. 
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C-Function 111 
Print Block 



Copyright 1984 by Software 2000, Inc. 
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^.. • -».. ' .. ' -» - .>.^. 



C-Function 111 

Entry Arguments 



Explanation 



Print Block 



I Reg I P£££llBfci£B 

CL = 111 

DS:DX = CCB address 



The Print Block function displays a string 
of characters on the console screen. The 
string may be of any length, and is defined 
by a Character Control Block (CCB) whose 
address is passed in DS:DX. The CCB is four 
bytes long, and has the following structure: 






0-1 starting DS-offset of string 
, 2-3 byte-length of string 



Horizontal tabs are expanded into multiple 
spaces, based upon tab stops at every eighth 
column. 
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C-Punction 112 
List Block 
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C-Punction 112 

Entry Arguments 



Explanation 



List Block 



i , ffeg j 



PSJgejipiipn 



CL = 112 

DS:DX = CCB address 



The List Block function sends a string of 
characters to be printed according to the 
current print routing. The string may be of 
any length, and is defined by a Character 
Control Block (CCB) whose address is passed 
in DS:DX. The CCB is four bytes long, and 
has the following structure: 



...Qff.S££_i ._. ^PsscxiPiipj^. 



0-1 starting DS-offset of string 
2-3 byte-length of string 



Horizontal tabs are not expanded. 
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C-Punction 134 
Make Queue 
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C-Function 134 

Entry Arguments 



Returned Value 



Explanation 



Hake Queue 

I Reg jJZI DsssxisXism 

CL = 134 

DS:DX = QD address 

AL = if successful 

-1 if cannot make queue 

The Make Queue function emulates the creation 
of an MP/M queue defined by a Queue Descrip- 
tor (QD) whose address is passed in DS:DX. 
The QD has the following structure: 

.QttSsiZ.1 P£££lipii£J3~ 



0-5 
6-13 
14-15 
16-17 



zeroes (internal use) 

queue name in ASCII (8 chars) 

message length 

maximum number of messages 



This function causes TurboDOS to create a RAM 
FIFO having the given queue name (mapped to 
upper case) and type ".QUE" on the system 
disk (may be changed by patching QUEDRV) 
under user number with the "global" attri- 
bute. Any file with the same name is dele- 
ted. Within the FIFO, the message length is 
rounded up to the next multiple of 128 bytes. 
The maximum number of messages must not 
exceed the capacity of a RAM FIFO (16,256 
bytes) and is rounded down as necessary. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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C-FUNCTIONS 

C-Function 135 
Open Queue 
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C-Function 135 

Entry Arguments 



Open Queue 

l 

I CL = 135 

i DS:DX *x qpb address 



Returned Value 



Explanation 



I 

I AL = if successful 

I -1 if cannot open queue 

I _ ._, _ : ,___. 



The Open Queue function opens an emulated 
MP/M queue. The queue is defined by a Queue 
Parameter Block (QPB) whose address is passed 
inX>S:DX. The QPB is 16 bytes long, and has 
the following structure: 



I _Q£k§££_J...^~ w^^PS5£JUPJtii2J3w. 



0-1 zero (internal use) 

2-3 queue pointer 

4-5 zero (internal use) 

6-7 buffer address (DS-offset) 

8-15 queue name in ASCII (8 chars) 



This function causes TurboDOS to open a RAM 
FIFO having the given queue name (mapped to 
upper case) and type ".QUE" as previously 
created by Make Queue (C-f unction 134). The 
Open Queue function fills in the "queue poin- 
ter" field of the QPB, and ignores the 
"buffer address" field. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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C-Function 136 
Delete Queue 
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C-Function 136 

Entry Arguments 



Delete Queue 

I , Reg | 

I 

I CL - 136 

I DS:DX « QPB address 



J2£££Xi£fei£&_ 



Returned Value 



Explanation 




Pescrlpfcipn .„,,.„ 



if successful 

-1 if cannot delete queue 



The Delete Queue function deletes an emulated 
MP/M queue. The queue is defined by a Queue 
Parameter Block (QPB) whose address is passed 
in.DS:DX. The QPB is 16 bytes long, and has 
the following structure: 

Juliet .lI->ZZw^-^Pii5xiiiI^5IZ 



0-1 zero (internal use) 

2-3 queue pointer 

4-5 zero (internal use) 

6-7 buffer address (DS-offset) 

8-15 queue name in ASCII (8 chars) 



The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Delete 
Queue function causes TurboDOS to close the 
queue and delete the associated RAM FIFO. 
The "buffer address" and 
of the QPB are ignored. 



"queue name" fields 



NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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C-Punction 137 
Read Queue 
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C-Punction 137 

Entry Arguments 



Returned Value 



Explanation 



Read Queue 

i , ffeg j _^. Pescrjptj-Qn 

I 

I CL ■ 137 

i DS:DX = QPB address 



,E£S~J-^~-^-^ , fiejgC£JJB£iSjX.-w^-u^-w-- 



AL = if successful 

-1 if queue not open 



The Read Queue function reads a message from 
an emulated MP/M queue. The queue is defined 
by a Queue Parameter Block (QPB) whose 
address is passed in DS:DX. The QPB is 16 
bytes long, and has the following structure: 



i 


.■,y.... -~^P£.§£lip£i£J3 w 1 


1 0-1 
1 2-3 
! 4-5 
1 6-7 
1 8-15 


i 
zero (internal use) 1 
queue pointer 1 
zero (internal use) 1 
buffer address (DS-offset) 1 
queue name in ASCII (8 chars) 1 


'— -> — ,.»-^ ->...-,.. 





The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Read 
Queue function reads a message from the queue 
into memory starting at the "buffer address" 
specified in the QPB. If the queue is empty, 
the calling program is suspended until a 
message becomes available, 
field of the QPB is ignored. 



The "queue name" 



NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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C-Function 138 
Cond. Read Queue 
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C-Function 138 

Entry Arguments 



Returned Value 



Explanation 



Conditional Read Queue 



Peg.i Pejgcjapiisn. 



CL - 138 

DS:DX = QPB address 



AL =0 if successful 

-1 if queue empty or not open 



The Conditional Read Queue function reads a 
message from an emulated MP/M queue. The 
queue is defined by a Queue Parameter Block 
(QPB) whose address is passed in DS:DX. The 
QPB is 16 bytes long, and has the following 
structure: 



. Qt i jggJfc I Pejgcxipiioji-. 



0-1 zero (internal use) 

2-3 queue pointer 

4-5 zero (internal use) 

6-7 buffer address (DS-offset) 

8-15 queue name in ASCII (8 chars) 



The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Condi- 
tional Read Queue function reads a message 
from the queue into memory starting at the 
"buffer address" specified in the QPB. If 
the queue is empty, the function returns 
immediately with a failure code (AL=-1). The 
"queue name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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G— Function 139 
Write Queue 
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C-Function 139 

Entry Arguments 



Returned Value 



Explanation 



Write Queue 

1 , Re g . i^mi!ll^l~~l^^jgi:iplig^ 



CL - 139 

DS:DX = QPB address 



J&fiSL-Lw.*. 



, wfiassxiptifijx^-:. 



AL = if successful 

-1 if queue not open 



The Write Queue function writes a message to 
an emulated MP/M queue. The queue is defined 
by a Queue Parameter Block (QPB) whose 
address is passed in DS:DX. The QPB is 16 
bytes long, and has the following structure: 



0-1 zero (internal use) 

2-3 queue pointer 

4-5 zero (internal use) 

6-7 buffer address (DS-offset) 

8-15 queue name in ASCII (8 chars) 



The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Write 
Queue function writes a message to the queue 
from memory starting at the "buffer address" 
specified in the QPB. If the queue is full, 
the calling program is suspended until space 
becomes available in the queue. The "queue 
name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 
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C-Function 140 
Cond. Write Queue 
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C-Function 140 

Entry Arguments 



Conditional Write Queue 

CL - 140 

DS:DX = QPB address 



Returned Value 



! , Reg „J J2fiJ5JCJcipilQjj 

AL = if successful 

-1 if queue full or not open 



Explanation 



The Conditional Write Queue function writes a 
message to an emulated MP/M queue. The queue 
is defined by a Queue Parameter Block (QPB) 
whose address is passed in DS:DX. The QPB is 
16 bytes long, and has the following struc- 
ture: 



.Offset J _J3fi^5XipJtiSJ3 

0-1 zero (internal use) 

2-3 queue pointer 

4-5 zero (internal use) 

6-7 buffer address (DS-offset) 

8-15 queue name in ASCII (8 chars) 



The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Condi- 
tional Write Queue function writes a message 
to the queue from memory starting at the 
"buffer address" specified in the QPB. If 
the queue is full, the function returns imme- 
diately with a failure code (AL=-1). The 
"queue name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in- 
cluded during TurboDOS system generation. 



4-72 



TurboDOS 1.4 8086 
Programmer's Guide 



C-FUHCTIONS 

C-Function 141 
Delay 
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C-Function 141 

Entry Arguments 



Delay 

Reg J , E&sjexipiicjx 

CL ■ 141 

DX = tick count 



Explanation 



The Delay function causes the calling process 
to be suspended for the period of time 
specified by the tick count passed in 
register DX. A system "tick" is an implemen- 
tation-dependent time interval, usually 1/50 
or 1/60 of a second. The actual delay may 
vary from the requested tick count by plus or 
minus one tick. 

If the specified tick count is zero, then the 
calling program is suspended only long enough 
to allow any other ready processes to run (a 
so-called "courtesy" dispatch) . 

NOTE; This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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All rights reserved. 

C-Function 142 Dispatch 

Entry Arguments I „ Reg , i . PejgSIpJkiSL-. 

I 

I CL - 142 



Explanation The Dispatch function causes the calling 

process to be suspended only long enough to 
allow any other ready processes to run (a so- 
called ""courtesy* dispa'tch) • 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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C-Function 143 Terminate 



Entry Arguments 1 Reg 1 £ejS£JUPJU£n ' 

I ' 

I CL = 143 1 



Explanation The Terminate function terminates the calling 

program ("warm-start"). It is honored for 
transient programs only, and is equivalent to 
System Reset (C-f unction 0). 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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C-Function 152 
Parse Filename 
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C-Function 152 

Entry Arguments 



Returned Value 



Explanation 






Parse Filename 



I . ftgg. 1 ... -—_.»__ pesprjpfciQn _ 

I 

I CL - 152 

I DS:DX = PFCB address 



lyRe.9,,,] . L , w-rf . 






JtesszXstisuL^. 



I 

I BX = if successful and end of line 
I OFFFFH if error while parsing 
I delimiter offset otherwise 

I DX = delimiter offset 



The Parse Filename function parses an ASCII 
file specification into FCB format. The 
function is called with the address of a 
Parse Filename Control Block (PFCB) in DS:DX. 
The PFCB is four bytes long, and has the 
following structure: 



0-1 
2-3 



DS-offset of ASCII input string 
DS-offset of destination FCB 



This function parses the first file 
specification it finds in the input string. 
Leading spaces are ignored. Parsing stops 
upon encountering a space, comma, semicolon, 
equal-sign, or any ASCII control character. 

The Parse Filename function parses an ASCII 
file specification of the form: 



(ud: }f ilenamei.typ} 
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Parse Filename 

(Continued) 

Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



C-Function 152 where "filename" is a name up to 8 characters 

long, n .typ" is an optional type up to 3 
characters" long, and~"ud:" is an optional 
user/drive prefix taking one of the following 
six forms: 



I i*i«e j3« n ii *3 # 
I UU • W i UUU • 



where "uu" is a decimal user number (0-31) 
and "d" is a drive letter (A-P) . 

The FCB drive, name, and type fields (bytes 
through 11) are initialized according to the 
parsed file specification. FCB bytes 12 and 
14 are zeroed. In the absence of a user 
number prefix, FCB bytes 13 and 15 are also 
zeroed. If the file specification includes a 
user number prefix, however, FCB byte 13 is 
set to the given user number, and FCB byte 15 
is set to -1 (OxFF). 



4-77 



TurboDOS 1.4 8086 
Programmer's Guide 



C-FDNCTIONS 

C-Function 153 
Get Console Number 
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C-Function 153 

Entry Arguments 



Get Console Number 



l-Ee£UJ_.™ PejSj£U£ti£JQ 



I CL = 153 I 



Returned Values 



Explanation 



1 , Reg , | 

I 

I AL 



.P£J55XlEtifiB , I 



console number 



The Get Console Number function returns a 
console number in register A. The console 
number is constructed by taking the network 
node number from the first entry of the cir- 
cuit assignment table (CKTAST) , adding a 
constant (RCNOFF, default 0), and masking 
with another constant (RCNMSK, default OxFF). 
The resulting console number should be unique 
in most simple (one circuit) networks. 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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C^Function 155 
Get Date and Time 
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C-Function 155 

Entry Arguments 



Explanation 



Get Date and Time 



CL = 155 

DS:DX = date/time packet address 



The Get Date and Time function returns the 
system date and time in a five-byte date/time 
packet whose address is passed in DS:DX. The 
date/time packet has the following structure: 



M&2&J w . P£££lip£iJ2JX~^ ~-w-» 

0-1 Date, represented as a 16-bit 
Julian date with 0x0000 corre- 
sponding to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi- 
nary coded decimal (BCD) digits 

4 Seconds, represented as two bi- 
nary coded decimal (BCD) digits 



'.»., ».»!-«!••— »WWMtf-»W-*W>*~M-*>-* ,w-*..»..»-»!-»w.»W-«. _-*.«•- -W-.»-»-. -- ~W-. -~.'-*.« 



This is a variation of C-function 105, with 
seconds returned in the packet rather than in 
a register. 
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C-Function 160 
Set List 
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C-Function 160 

Entry Arguments 



Set List 

I fieg 1 



_Jejgj?JclEtiS. 



CL - 160 

DL = list device number (0-15) 



Explanation 



The Set List function saves the list device 
number passed in register DL for use by a 
subsequent Conditional Attach List cc- func- 
tion 161). 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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C-Punction 161 
Cond. Attach List 



Copyright 1984 by Software 2000, Inc. 
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C-Punction 161 

Entry Arguments 



Conditional Attach List 

I 

I CL = 161 



Returned Value 



Explanation 



I 

I AL = 



The Conditional Attach List function sets the 
current printer number or queue number to the 
device specified in a prior Set List (C-func- 
tion 160). The print mode (direct, spooled, 
console) and spool drive are not affected. 
See T-f unction 27 (Get/Set Print Mode). 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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(Intentionally left blank.) 
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T-PUNCTIONS This section describes the TurboDOS-unique 

functions ( w T-f unctions") which supplement 
the C-functions described in the previous 
section. The T-functions are presented in 
numerical order, with calling parameters, 
return values, and a detailed explanation for 
each. 

To invoke a T-function, a program executes 
the interrupt instruction INT 223 (INT OxDF) 
with a function number in register CL. 
Arguments are passed and values returned in 
registers, as described below for each T- 
function. 

If a T-function call is made with register CL 
set to an unsupported function number, Turbo- 
DOS returns immediately with register AX set 
to zero. 

T-function calls generally destroy registers 
AX-BX-CX-DX-SI-DI-BP-ES, but preserve SP-IP 
and CS-DS-SS. 
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T-Punction Reset Operating System 

Entry Arguments I , Reg ', i^^IIZ^IIIIII5iiiIIpIIB5IIIIIIIIIIIII I 

I I 

I CL - I 

Explanation The Reset Operating System function unlocks 

all locked records, closes all open files, 
unlocks all locked drives, and terminates any 
network sessions involving the calrring" 
process. 

TurboDOS automatically performs this function 
at each program termination (warm-start), so 
it is almost never necessary for a program to 
call this function explicitly. 
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T— Function 1 
Create Process 
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T-Function 1 

Entry Arguments 



Create Process 

. Reg , j IZIHIIIIIIpii^xIpli^- 



CL 

DX 
BX 



- 1 



entrypoint offset 
workspace offset 






Returned Value 



Explanation 



Reg 1 ^^JPejgjgxipjfcigil 

AL = if successful 

-1 if insufficient memory 



The Create Process function creates a new 
process which starts execution at the entry- 
point offset passed in register DX. The new 
process is assigned a TurboDOS work area 
whose offset appears to the new process in 
register SI, and a 64-word stack area whose 
offset appears in register SP. If the 
process requires a re-entrant work area 
(usually allocated dynamically using T- 
f unction 3) , its offset should be passed in 
register BX and will appear to the new 
process in register DI. 

If this function is called with register DX 
set to zero, it causes the calling process to 
terminate. 

NOTE: This function is intended to be invoked 
only by resident processes within TurboDOS. 
It deals with 16-bit offset values that are 
relative to the operating system base. 
Consequently, it should never be invoked from 
a transient program. 
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T-Punction 2 
Delay Process 
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T-Function 2 

Entry Arguments 



Delay Process 



Explanation 



, Reg i P£j&£xipjtioa_. 

CL - 2 

DX « tick count 



The Delay Process function causes the calling 
process to be suspended for the period of 
time specif ied by the tick count passed in 
register DX. A system "tick" is an implemen- 
tation-dependent time interval, usually 1/50 
or 1/60 of a second. The actual delay may 
vary from the requested tick count by plus or 
minus one tick. 

If the specified tick count is zero, then the 
calling program is suspended only long enough 
to allow any other ready processes to run (a 
so-called "courtesy" dispatch). 
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T-Function 3 
Allocate Memory 
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T-Function 3 

Entry Arguments 



MJW»w. 






Allocate Memory 

I , fieg j , 

I 

I CL = 3 

I DX = byte-length of requested segment 



j&B£cxiJ2fcisa~ 



Returned Values 



I 

I AL = if successful 

I -1 if insufficient memory 

I BX = segment offset (if successful) 



Explanation 



The Allocate Memory function allocates a 
contiguous memory segment of the byte-length 
requested in register DX. If successful, the 
starting offset of the allocated segment is 
returned in register BX. 

NOTE: This function is intended to be invoked 
only by resident processes within TurboDOS. 
It deals with 16-bit offset values that are 
relative to the operating system base. Con- 
sequently, it should never be invoked from a 
transient program. If a memory segment is 
allocated by a process and not deallocated 
before the process terminates, then the space 
is lost permanently. 
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T-Function 4 
Deallocate Memory 
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T-Function 4 

Entry Arguments 



Deallocate Memory 

1 1 Reg HIIIIZZIIIII5iiijIi£iBB- 

cl - 4 

DX = segment offset 



Explanation 



The Deallocate Memory function returns a 
previously-allocated memory segment to the 
pool of available memory space. 



NOTE: This function is intended to be invoked 
only by resident processes within TurboDOS. 
It deals with 16-bit offset values that are 
relative to the operating system base. Con- 
sequently, it should never be invoked from a 
transient program. The offset passed in DX 
must be a segment starting offset returned by 
a prior call to C-function 3 (Allocate Memo- 
ry), otherwise a system crash may occur. 
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T-Function 5 
Send I/P Message 
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T-Function 5 

Entry Arguments 



Explanation 



Send Interprocess Message 



CL 
DX 
BX 



= 5 



message node offset 
message offset 



The Send Interprocess Message function pro- 
vides a means to send messages from one pro- 
cess to another. Register DX specifies the 
offset of a 10-byte message node which must 
be initialized as follows: 



1 MSGNOD: WORD 





; semaphore 


count 


1 WORD 


MSGNOD+2 , 


; semaphore 


head 


1 , WORD 


MSGNOD+2 , 


» *» 


n 


1 WORD 


MSGNOD+4 t 


imsg chain 


head 


1 WORD 


MSGNOD+4 J 


, n n 


M 



Register BX specifies the offset of the 
message to be sent, which must be prefixed by 
a 4-byte linkage as follows: 






MESSAG: WORD 

WORD 

BYTE . . . 

BYTE . . . 



message linkage 

n n 

message text 
(any length) 



NOTE: This function is intended to be invoked 
only by resident processes within TurboDOS. 
It deals with 16-bit offset values that are 
relative to the operating system base. Con- 
sequently, it should never be invoked from a 
transient program. 
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T-PDNCTIOHS 

T-Punction 6 
Receive I/P Message 
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T-Punction 6 

Entry Arguments 



Receive Interprocess Message 

LissuL w^^^J^siibipIiBL 

I 

I cl - 6 

I DX = message node offset 



Returned Value 



Explanation 



l ,Reg,i ~ P££j?jcip±ip£ 

I 

I BX = message offset 



The Receive Interprocess Message function 
provides a means to receive messages sent by 
another process using C-function 5 (Send 
Interprocess Message). Register DX specifies 
the offset of a 10-byte message node which 
must be initialized as follows: 



MSGNOD: WORD ; semaphore count 

WORD MSGNOD+2 ; semaphore head 

WORD MSGNOD+2 ; " " 

WORD MSGNOD+4 ;msg chain head 

WORD MSGNOD+4 ; " " " 



If no message is available from the specified 
message node, the calling process is suspen- 
ded until a message arrives. This function 
returns in BX the offset of the received 
message prefixed by a 4-byte linkage. 

NOTE: This function is intended to be invoked 
only by resident processes within TurboDOS. 
It deals with 16-bit offset values that are 
relative to the operating system base. Con- 
sequently, it should never be invoked from a 
transient program. 
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Set Error Address 
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T-Function 7 

Entry Arguments 



Explanation 



Set Error Address 



CL 
DX 



= 7 



error intercept routine offset, or 
to restore default error handling 
BX =s error intercept routine base 



The Set Error Address function enables a 
program to establish its own error intercept 
routine to intercept and process unrecover- 
able disk errors. The address of the inter- 
cept routine is passed in BX (base) and DX 
(offset). Normal TurboDOS error diagnosis is 
supressed. 

The error intercept routine must &£t call any 
TurboDOS functions, and must return via a 
RETF instruction with register AL set to the 
desired error recovery alternative: 

.AIcEfigJE Hicj3ye*y_Aciioji__I Z7 




+1 
-1 



retry operation 
ignore error 
abort program 



If the Set Error Address function is called 
with DX set to zero, normal TurboDOS error 
diagnosis is restored. This also happens 
automatically when the program terminates. 
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T-Function 8 
Set Abort Address 
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T-Function 8 

Entry Arguments 



Set Abort Address 

I !fieg .lZZZZZZIZIZZ—E£S£XiE£iQQ 



CL 
DX 



- 8 



BX = 



abort intercept routine offset, or 
to restore default abort handling 
abort intercept routine base 



Explanation 



The Set Abort Address function enables a 
program to establish Its own abort Intercept' 
routine to intercept and process user-reques- 
ted aborts (in response to attention-requests 
or disk errors). The address of the inter- 
cept routine is passed in BX (base) and DX 
(offset) . 

The abort intercept routine may exit via a 
RETF instruction to resume execution of the 
program at the point of interruption. Alter- 
natively, it may proceed with any desired 
wrap-up processing and then terminate the 
program (via C-f unction 0) . 

If the Set Abort Address function is called 
with DX set to zero, normal TurboDOS abort 
handling restored. This also happens automa- 
tically when the program terminates. 
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T-Function 9 
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T-Function 9 

Entry Arguments 



Explanation 



Set Date and Time 



, fceg , J , 



.J2£5£XipJti5J3w. 



CL 
BX 
DH 
DL 
CH 



■ 9 



Julian date (0 is 31 December 1947) 
hours (0-23, binary integer) 
minutes (0-59, binary integer) 
seconds (0-59, binary integer) 



The Set Date and Time function sets the sys- 
tem date and time. The Julian date passed in 
register BX is the number of days since the 
base date of 31 December 1947. Dates prior 
to the base date are represented by negative 
values. 

The system date and time may also be set by 
means of C-f unction 104 (Set Date and Time), 
but the format of arguments is considerably 
different. 
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T-F0NCTIONS 

T-Punction 10 
Get Date and Time 
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T-Punction 10 

Entry Arguments 



Get Date and Time 

I Reg J ISii5iiiII5iIIZIIH 

I 

l cl = 10 



Returned Values 



Explanation 



.Reg. J— 



Eje&ciipiiSB I 



BX = Julian date (0 is 31 December 1947) I 

DH = hours (0-23, binary integer) I 

DL - minutes (0-59, binary integer) i 

CH = seconds (0-59, binary integer) I 

CL = system tick count I 






The Get Date and Time function returns the 
system date and time. The Julian date re- 
turned in register BX is the number of days 
since the base date of 31 December 1947. 
Dates prior to the base date are represented 
by negative values. 

The system tick count returned in register CL 
is incremented every system tick. It counts 
from zero to 255, then wraps around to zero. 
A system tick is an implementation-dependent 
time interval, usually 1/50 or 1/60 of a 
second. 

The system date and time may also be interro- 
gated by means of C-function 105 (Get Date 
and Time), but the format of returned values 
is considerably different. 
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T-Function 11 
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T-Function 11 

Entry Arguments 



Returned Value 



Rebuild Disk Map 

l , Reg- i P£Sje*lp£iojk 

CL ■ 11 

DL = disk drive: 

for drive A 

X 1V1. U11VC £7 

15 for drive P 

AL = if successful 

-1 if disk write-protected 
or has files open 



Explanation 



The Rebuild Disk Map function regenerates the 
allocation map on the disk drive specified in 
register DL. The principal purpose of this 
function is to support the FIXMAP command. 
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T-Funetion 12 
Return Serial Number 
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T-Function 12 

Entry Arguments 



Return Serial Number 

I [ Reg . jIIZIIIZII"Ipiiini55E 
I 

I cl = 12 



Returned Values 



Explanation 



I , Peg , 1 Ess ejeipjtian I 

I I 

I BX = TurboDOS origin number I 

I DX = TurboDOS unit number I 

I CH = if non-privileged log-on I 

I 0x80 if privileged log-on I 

I CL = 0x14 (TurboDOS version 1.4) I 



The Return Serial Number function returns the 
origin and unit numbers with which this par- 
ticular copy of TurboDOS was serialized, and 
may be used in application programs to help 
prevent unauthorized use. 

This function also returns the TurboDOS ver- 
sion number, and a flag which indicates 
whether or not the current log-on is privi- 
leged. 
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T-Functioii 13 
Set Compatibility 
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T-Punction 13 

Entry Arguments 



Explanation 






Set Compatibility Flags 



CL 
DL 



= 13 



compatibility flags: 

bit 7 = permissive flag 
bit 6 = suspend flag 
bit 5 = global-write flag 
bit 4 « mixed-mode flag 
bit 3 = logical flag 
(bits 2-0 not defined) 



The Set Compatibility Flags function enables 
a program to modify the rules by which file 
sharing is done. The meaning of each compa- 
tibility flag is described in section 2. 

When the program terminates, the compatibili- 
ty flags revert automatically to the default 
values assigned to the public symbol COMPAT 
at system generation. 
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T-Punction 14 
Log-On/Log-Of f 
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T-Function 14 

Entry Arguments 



Returned Value 



Explanation 



Log-On/Log-Off 



Reg 1 



™P££££iPJfcii2J3- 



CL 
DX 
DL 



= 14 



OxFFFF (if log-Off) 
user number 0-31 (if log-on) 
with bit 7 set for privileged 
DH = current disk drive (if log-on) : 
-1 for no change 
for drive A 
1 for drive B 

15 for drive P 



^B^S-J^--* w . 



Jtessiipiisn .. 



AL = if successful 

-1 if request invalid 

The Log-On/Log-Off function is provided to 
support log-on security via the LOGON and 
LOGOFF commands. To log-on f this function is 
called with the desired user number in regis- 
ter DL (with bit 7 set if a privileged log-on 
is desired), and with the desired current 
drive in register DH (or -1 for no change in 
current drive). To log-off, the function is 
called with DX set to OxFFFF. 



After a log-off, another log-on request is 
not honored until a warm-start or C-function 
(System Reset) has occurred. 

NOTE: When this function is called from a 
resident system process, the argument in DH 
is ignored. 
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Load File 
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T-Function 15 Load File 



entry Arguments i , fleg J JUe££U&£J 

I 

I CL - 15 



i^mu sxxti*^ ; 

I AL = I 

Explanation The Load File function performs no operation 

under 8086 TurboDOS. Use C-function 59 
(Program Load) to load programs and overlays 
stored in .CMD format. 
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T-Function 16 
Activate Do-Pile 
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T-Function 16 

Entry Arguments 






Activate Do-File 

i , Reg^j ZZ^^lZZZZZS^lliiilmZZZZZ. 

i 

I CL ■ 16 

I DS:DX = FCB address (to activate) 

I DX = (to cancel) 



Returned Value 



Explanation 



1 jteg j 



JteS££i££iQQ-~-~~^~~~-^~~ 1 



AL = if successful 

-1 if file not found 



The Activate Do-File function causes the file 
specified by the FCB drive, name, and type 
fields (bytes through 11) to be activated 
as a do-file. The file need not have been 
opened. Any currently-active do-file and/or 
command line is stacked (to be reactivated 
when the new do-file has been processed to 
completion). The principal purpose of this 
function is to support the DO command. 

This function may also be called with DX set 
to zero to cancel all active and stacked do- 
files. 



5-18 



TurboDOS 1,4 8086 
Programmer's Guide 



T-FUNCTIONS 

T— Function 17 
Dis/Enable Autoload 
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T-Function 17 

Entry Arguments 



Disable/Enable Autoload 



I ^ESS^i^^^w^^^w^JJ 



CL 
DL 



= 17 



to disable autoload 
-1 to enable autoload 




Explanation 



The Disable/Enable Autoload function may be 
used to disable the warm-start autoload fea- 
ture of TurboDOS, or to re-enable the feature 
after it has been disabled. 

TurboDOS automatically disables the warm- 
start autoload feature whenever it fails to 
find the file WARMSTRT.AUT on the current 
disk during a warm-start. Creating such a 
file on disk (or changing the current disk to 
one that contains such a file) will not 
result in autoloading unless the autoload 
feature is explicitly re-enabled by means of 
this function. 
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T-Punction 18 
Send Command Line 
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T-Function 18 

Entry Arguments 



Send Command Line 

I . Reg . J - ZII™P£J5£XiPii£n 

CL = 18 

DS:DX = buffer address (to send) 

DX = (to cancel) 



Explanation 



The Send Command Line function allows a pro- 
gram to specify the next command line to be 
processed by TurboDOS after the program ter- 
minates. The buffer address is passed in 
DS:DX. The first byte of the buffer must 
contain the command line byte-length, and the 
command line text must occupy the second and 
succeeding bytes of the buffer. Any 
currently-active command line is stacked, and 
the new command line is activated. 

The commands are echoed to the console as 
they are executed, unless the command line 
starts with a leading command separator 
(backslant) character. 

This function may also be called with DX set 
to zero to cancel all active and stacked 
command lines. 
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T-Function 19 

Entry Arguments 



Returned Values 



Explanation 



Return Disk Allocation Information 



.^ESS-i..— .-w^—w-^ P&§ejciPii< 

CL = 19 

DL = disk drive: 

for drive A 

1 for drive B 

15 for drive P 






,Reg J Pe^jupiiss 

AL = block size: 

3 for IK blocks 

4 for 2K blocks 

7 for 16K blocks 
plus: bit 7 set if fixed disk 

bit 6 set if EXM=0 forced 
CL ■ number of blocks in the directory 
DX = number of blocks presently unused 
BX = total number of blocks on the disk 



The Return Disk Allocation Information func- 
tion returns various parameters concerning 
the logical organization of the specified 
disk drive. 
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T-Punction 20 
Return Physical Info 
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^^mJ^wmWwmUUU. 






T-Punction 20 

Entry Arguments 



Returned Values 



Explanation 



Return Physical Disk Information 



CL = 20 

DL = disk drive: 

for drive A 

1 for drive B 

15 for drive P 



Reg J _^_ Pescrjptjop, L L L ,.,...., 

AL = physical sector size: 

for 128-byte sectors 

1 for 256-byte sectors 

2 for 512-byte sectors 

3 for IK sectors 

• 

7 for 16K sectors 
CX = number of reserved (boot) tracks 
DX = total number of tracks on the disk 
BX = number of sectors per track 



The Return Physical Disk Information function 
returns various parameters concerning the 
format and physical organization of the 
specified disk drive. 
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Get/ Set Drive status 
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T-Punction 21 

Entry Arguments 



Get/Set Drive Status 



Returned Values 



Explanation 



Reg i ^ testtlptiML 



CL = 21 

DL = disk drives 

for drive A 

1 for drive B 

• 

15 for drive P 
DH = to set the drive read/write 
1 to set the drive read-only 
-1 to return the drive status 



■■ R e g .i ^JPe^jsiipjfcipii 

AL = if successful 

-1 if attempt to set drive status 
while files are open 
BL = if drive is not ready 

-1 if drive is ready 
BH = if drive is read/write 

-1 if drive is read-only 



The Get/Set Drive Status function may be used 
to interrogate the ready and write-protect 
status of the drive specified by register DL. 
This function may also be used to change the 
write-protect status of the drive. The code 
passed in register DH controls which of these 
operations is performed, as indicated above. 
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T-Function 22 

Entry Arguments 



Returned Value 



Explanation 



Physical Disk Access 

Reg . IZZIZZZZZZZZZZisssxJ^xJSB 

CL - 22 

DS:DX = PDR packet address 

AL = if read/write successful, or 
drive not ready 
-1 if read/write unsuccessful, or 
drive is ready 



The Physical Disk Access function provides 
direct access to the physical disk drivers. 
The principal purpose of this function is to 
support the BOOT, BACKUP, FORMAT, and VERIFY 
commands. It is honored for privileged log- 
ons only, and may be used only for disk 
drives local to the calling processor. 

DS:DX contains the address of a 16-byte phy- 
sical disk request (PDR) packet with the 
following structure: 



Qffs< 



J&££jup£ign. 




1 

2-3 

4-5 

6-7 

8-9 

10-11 

12-13 

14-15 



disk operation code (0-4) 

disk drive (0-15) 

physical track number (base 0) 

physical sector number (base 0) 

number of sectors to read/write 

number of bytes to read/write 

DMA offset for read/write 

DMA base (para) for read/write 

disk specification table address 



The physical operation performed depends upon 
the disk operation code in the PDR packet. 
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T-Funetion 22 

Physical Disk Access 

(Continued) 
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Explanation 
(Continued) 



If the PDR opcode is 0, the specified number 
of physical sectors (or bytes) are read from 
the specified drive, track, and sector into 
the specified DMA address. 

If the PDR opcode is 1, the specified number 
of physical sectors (or bytes) are written to 
the specified drive, track, and sector from 
the specified DMA address. 

If the PDR opcode is 2, the type of the 
specified disk is determined, and an 11-byte 
disk specification table (DST) is returned at 
the specified DMA address, structured as 
follows: 



_Q££jg&Jfc^i 



E£j5£lipJfciiMi 



block size (3=1K,4=2K, . . . ,7=16K) 

1-2 total number of blocks on disk 

3 number of directory blocks 

4 sector size (0=128,. .. ,7=16K) 
5-6 number of sectors per track 
7-8 number of tracks on the disk 
9-10 number of reserved (boot) tracks 



If the PDR opcode is 3, the ready status of 
the specified drive is returned in register 
AL (0 if not ready, -1 if ready). 

If the PDR opcode is 4, the specified track 
of the specified drive is formatted, using 
hardware-dependent formatting information 
provided at the specified DMA address. 

NOTE: Opcodes (read) and 1 (write) require 
that the PDR packet contain the address of a 
valid DST for the specified disk. Therefore, 
opcode 2 (return DST) should be invoked first 
to obtain the DST. 
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Set Buffer Parameter 
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T-Function 23 

Entry Arguments 



Explanation 



Set Buffer Parameters 



Reg 1 



.P£J3£JlPii.£J3 



CL 
DH 
DL 



- 23 



number of buffers (minimum 2) 
buffer size: 

for 128-byte buffers 

1 for 256-byte buffers 

2 for 512-byte buffers 

3 for IK buffers 

7 for 16K buffers 



The Set Buffer Parameters function enables 
the number and size of disk buffers to be 
changed. The principal purpose of this func- 
tion is to support the BUFFERS command. 

The specified number of buffers must be at 
least 2. If the specified number of buffers 
cannot be allocated due to insufficient 
memory, then TurboDOS allocates as many as it 
can. The specified buffer size must be as 
least as large as the largest physical disk 
sector size being used. 

If this function is called from a slave pro- 
cessor without local disk storage, then the 
function is passed over the network to be 
processed in the master. 
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T-Function 24 

Entry Arguments 



Returned Values 



Explanation 



Get Buffer Parameters 



..Beg., J 



.EejBJSJClEtiojX 



CL « 24 



, fieg L J 



PeJSJSJCipJtiPJj^. 



BH = number of buffers 
BL = buffer size: 

for 128-byte buffers 

1 for 256-byte buffers 

2 for 512-byte buffers 

3 for IK buffers 

• 

7 for 16K buffers 



The Get Buffer Parameters function enables 
the number and size of disk buffers to be 
interrogated. The principal purpose of this 
function is to support the BUFFERS command. 

If this function is called from a slave pro- 
cessor without local disk storage, then the 
function is passed over the network to be 
processed in the master. 
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T-Function 25 

Entry Arguments 



Returned Value 



Explanation 



Lock/Unlock Drive 

, fieg j ^PeSCjCiPJtlpjX- 

CL = 25 

DL = disk drive: 

for drive A 

1 for drive B 

15 for drive P 
DH = to unlock drive 
-1 to lock drive 

ww wwJteSCjcjifcicjj , w . 

AL = if successful 

-1 if drive in-use or already 

locked by another process 



The Lock/Unlock Drive function enables a 
program to secure a lock on a specified disk 
drive. This function is used by many Turbo- 
DOS commands such as BACKUP, CHANGE, FIXDIR, 
FIXMAP, FORMAT, and VERIFY to ensure that 
they cannot compromise the processing of 
other users. 
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T-Function 26 

Entry Arguments 



Flush/Free Buffers 



Explanation 



.£e££xJ,p£i£iL 



CL « 26 

DL = disk drive: 

for drive A 

JL 1U1 UtXVC D 

• 

15 for drive P 
DH = subf unction flags: 

bit 7 set to free buffers uncon- 
ditionally 

bit 6 set to free buffers after 
disk error abort 

bit 5 set to continue after disk 
error abort 

bit 4 set to return after disk 
error abort 



The Flush/Free Buffers function causes all 
written-to disk buffers for the specified 
disk drive to be written out (flushed) to the 
disk. This function may cause disk buffers 
for the specified drive to be freed, condi- 
tionally or unconditionally, according to the 
subfunction flags passed in register DH. 

It is suggested that this function be used 
prior to media changes and physical disk 
access (T-f unction 22). 
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T-Ftmction 27 

Entry Arguments 



Returned Values 



Explanation 



Get/ Set Print Node 



.J&fiS-J Jee^£*iPi±oj* 

CL = 27 

DL = print mode: 

to print direct 

1 to print spooled 

2 to print to the console 

-1 to leave print mode unchanged 
DH = pr inter assignment (if mode * ) 
queue assignment (if mode = 1) 
-1 to leave assignment unchanged 
CH = spool drive: 

for drive A 

1 for drive B 

15 for drive P 

-1 to leave spool drive unchanged 



Re g | 



.J2£J5£JCiPJti£J3. 



If B » D = E = -1 on entry, returns with: 
AL = current spool drive 
BH = current printer or queue assignment 
BL = current print mode 



The Get/Set Print Mode function is used to 
set or interrogate print routing, and is 
provided to support the PRINT command. 

Printer and queue assignments are coded thus: 
1 for A, 2 for B, ..., 16 for P. Assignment 
to queue zero causes print files to be left 
unqueued. Assignment to printer zero causes 
print output to be discarded. Setting the 
assignment, mode, or spool drive implies an 
immediate end-of-print- job condition. If 
registers CH, DH, and DL are all set to -1, 
this function simply interrogates and returns 
the current assignment, mode, and drive. 
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T-Function 28 

Entry Arguments 

Explanation 



Signal End-of- Print 

1 , fieg , J Description I 

I I 

! CL = 28 I 

The Signal End-of-Print function causes an 
end-of-print condition. If spooling is in 
effect, the current print file is closed and 
(if appropriate) enqueued for background 
printing. 

An end-of-print condition may also occur as 
the result of a warm-start, attention re- 
quest, or end-of-print character. 
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Get/Set De spool Mode 
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T-Function 29 

Entry Arguments 



Returned Values 



Explanation 



Get/Set De-Spool Node 



IJ&SS-J- 


*-^~^_«..^._^ ^Jp££CJCJj^£JLojQ w _.^_.„ 


— ™- 


1 CL = 


29 




1 CH = 


printer: 

for printer A 

1 for printer B 

• 
• 

15 for printer P 




1 DL = 


de-spool mode: 

to process print job 

1 to suspend print job 

2 to begin print job over 

3 to terminate print job 
-1 to leave mode unchanged 




1 DH = 


de-spool queue assignment: 

to set printer off-line 

1 for queue A 

2 for queue B 

• 

16 for queue P 






-1 to leave queue unchanged 


* 


I .Reg, J 


T T ., , T r , , Description L L u u L L 




1 AL - 


if successful 

-1 if invalid request 




1 If D = 


= E = -1 on entry, returns with: 




1 BH = 


current queue assignment (0-16) 




1 BL = 


current de-spool mode (0 or 1) 





The Get/Set De-Spool Mode function is used to 
control background printing, and is provided 
to support the PRINTER command. If registers 
DH and DL are both set to -1, this function 
simply interrogates and returns the current 
queue assignment and de-spool mode for the 
specified printer. 
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T-Function 30 

Entry Arguments 




Returned Value 



Explanation 



■ Reg..l 



JBe££xip£i!2& 



CL - 30 

DS:DX = FCB address 

BH = print queues 

for queue A 

1 for queue B 

15 for queue P 
BL = user number (0-31) , plus 

bit 7 set to delete after printing 



■ Reg - J — DSJ^lPJfciJWL 



hL = if successful 

-1 if invalid request 



The Queue a Print File function enqueues a 
text file on a specified print queue for 
background printing. The file to be enqueued 
is identified by the FCB drive, name and type 
fields (bytes through 11), together with 
the user number passed in register BL. 

The drive specified by the FCB must be acces- 
sible by the processor in which the specified 
queue resides, otherwise the request is 
invalid. To check this, the function may be 
called with register BL set to -1, in which 
case the FCB drive and requested queue are 
checked for validity but no file is queued. 
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Flush List Buffer 
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T-Function 31 Flush List Buffer 



Entry Arguments 1 Reg 1 Eej5£jupjfcj,£n_ 

I 

I CL = 31 



Explanation The Flush List Buffer function is used by 

TurboDOS during direct printing over the 
network to force any remaining buffered char- 
acters to be printed. There should be no 
need for an application program to call this 
function. 
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T-Function 32 

Entry Arguments 



Explanation 



Network List Out 

I Reg J 




The Network List Out function is used by 
TurboDOS during direct printing over the 
network. There should be no need for an 
application program to call this function. 
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Remote Console I/O 
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T-Punction 33 



Entry Arguments 



«^W.*..*».*W..W.«:-<i2- 



Remote Console I/O 



I Reg. 1 Pe^ cjcipii sil 



CL 
DL 



- 33 



console input character, or 
I if no console input available 
I DH = o to detach remote console 
I -1 to attach remote console 



Returned Value 



Explanation 



I , fieg | Pes cxiPJfci ojJ I 



I 

I AL = if CONREM not present 

I 1 if successful 

I -1 if executing in master 



The Remote Console I/O function works in 
conjunction with the CONREM console driver to 
support the MASTER command. It passes one 
byte of console input in register DL (if 
available), and returns a count byte and up 
to 127 bytes of console output at the current 
DMA address. There should be no need for an 
application program to call this function. 



5-36 



TurboDOS 1*4 8086 
Programmer's Guide 



*p— PU jj(]|ij» JONS 

T-Funetion 34 
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T-Function 34 

Entry Arguments 



Get Comm Channel Status 

I 

I CL = 34 

I DH = channel number, plus 

I bit 7 set if remote channel 



Returned Value 



IJRfiSLJ-w- 



, ^^^JBs^iSxipJtiiJikw^^^^w-w^^ i 



AL = if input character not available 
-1 if input character is available 



Explanation 



The Get Comm Channel Status function checks 
to see whether or not an input character is 
available on the specified comm channel. If 
a character is available, it returns A = -1. 
Otherwise, it returns A = 0. 
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T-Function 35 
Comm Channel Input 
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T-Function 35 

Entry Arguments 



Comm Channel Input 

I ,fieg L J 



££S£Xi£&lQQ I 



I 

I CL - 35 

I DH = channel number, plus 

I bit 7 set if remote channel 



Returned Value 



Explanation 



l-J&ss~L Ps&cjEipiiojL 



AL = input character 



The Comm Channel Input function obtains the 
next input character from the specified comm 
channel, and returns in in register AL. If no 
character is available, the calling program 
is suspended until a character is received. 
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"-Function 36 
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T-Punction 36 

Entry Arguments 



Comm Channel Output 



CL 
DH 



i n<«- 



jjjj = 



JDte£££i£&i£Dl 



= 36 



channel number, plus 

bit 7 set if remote channel 

output character 



Explanation 



The Comm Channel Output function outputs the 
character passed in register DL on the speci- 
fied comm channel. 
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T-Function 37 

Entry Arguments 



Set Coram Baud Rate 



, fieg , I . Pe^cjciPiifiB 



CL 
DH 



- 37 



Explanation 



channel number, plus 
bit 7 set if remote channel 
DL = baud rate code (bits 3-0) : 

for 50 baud 8 for 1800 baud 

1 for 75 baud 9 for 2000 baud 

2 for 11-0 baud 10 for 2400 baud 

3 for 134.5 baud 11 for 3600 baud 

4 for 150 baud 12 for 4800 baud 

5 for 300 baud 13 for 7200 baud 

6 for 600 baud 14 for 9600 baud 

7 for 1200 baud 15 for 19200 baud 
plus bit 7 set for att'n detection 

bit 6 this channel is a CTS 
protocol channel 

bit 5 set for disabled receive 
interrupt 

bit 4 this channel is an XON/ 
XOFF protocol channel 



The Set Comm Baud Rate function sets the baud 
rate and options passed in register DL on the 
specified comm channel. The protocol can be 
set to CTS, XON, or none. 
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T-Punction 38 

Entry Arguments 



Get Comm Baud Rate 

\ Reg \ jJZIIZZIIIIIjSiiHi5B5" 



CL 
DH 



- 38 



channel number, plus 

bit 7 set if remote channel 






Returned Value 



, fieg | SsSSXiSXlQJZ 

AL = baud rate code (bits 3-0) : 

for 50 baud 8 for 1800 baud 

1 for 75 baud 9 for 2000 baud 

2 for 110 baud 10 for 2400 baud 

3 for 134.5 baud 11 for 3600 baud 

4 for 150 baud 12 for 4800 baud 

5 for 300 baud 13 for 7200 baud 

6 for 600 baud 14 for 9600 baud 

7 for 1200 baud 15 for 19200 baud 
plus bit 7 set for att'n detection 

bit 6 this channel is a CTS 
protocol channel 

bit 5 set for disabled receive 
interrupt 

bit 4 this channel is an XON/ 
XOFF protocol channel 



Explanation 



The Set Comm Baud Rate function interrogates 
the baud rate and options for the specified 
comm channel, and returns this information in 
register AL. 
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T-Punction 39 



Set Modem Controls 



Entry Arguments 



fie g I Description 



CL 
DH 



= 39 



channel number, plus 
bit 7 set if remote channel 
DL = modem control vector: 

bit 7 set for request-to-send 

set for data-terminal-ready 
set for 1 - 8 bits/char I 
0=7 bits/char 
bit 4 set for 1 = even parity I 
= odd parity 
set for 1 parity enabled 
set for 1 handshaking 
enabled 
bits 1-0 reserved 



bit 
bit 



bit 
bit 



Explanation 



The Set Modem Controls function sets the 
modem control signals in accordance with the 
vector passed in register DL on the specified 
comm channel. 
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T-Function 40 

Entry Arguments 



Get Modem Status 




sription, 



channel number, plus 

bit 7 set if remote channel 



Returned Value 



Explanation 



,fieg, J 



DasjCiipJfci^Ji 



AL = modem status vector : 

bit 7 set for clear-to-send 
bit 6 set for data- set- ready 

SCC does not have (Model 

1200 = CPU ports) 
bit 5 set for data-carrier-detect 
bit 4 set for ring-indicator 

SCC does not have (Model 

1200 = CPU ports) 
bits 3-0 reserved 



The Set Modem Status function interrogates 
the modem status signals for the specified 
comm channel, and returns this information as 
a vector in register AL* 
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T-Function 41 

Entry Arguments 



User-Defined Function 



Returned Values 



Explanation 



: .Description,, 



CL 
CH 



- 41 



DX 
BX 



AL 
CX 
DX 
BX 



network routing: 

if always processed locally 
Id hex if routed per drive d 
2p hex if routed per printer p 
3q hex if routed per queue q 
-1 if touted to default net -addr 
-2 if routed to net addr in DX 
user-defined argument passed, 
or network address (if CH=-2) 
user-defined argument passed 



Dfi&gilpiifiB 

= user-defined value returned 
= user-defined value returned 
= user-defined value returned 
= user-defined value returned 



The User-Defined Function provides a means 
for adding user-defined extensions to the 
operating system taking full advantage of the 
TurboDOS networking facilities. On entry, 
register CH defines how the request is to be 
routed over the network. Registers DX and BX 
plus the 128-byte record at the current DMA 
address are all passed (over the network if 
necessary) to a user-defined module with the 
public entrypoint symbol USRFCN. Upon entry 
to the USRFCN routine, ES:CX contains the 
address of the 128-byte record that was 
passed. The USRFCN routine may return infor- 
mation to the caller in any of the registers 
AL-BX-CX-DX and in the 128-byte record. 
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T-Function 42 

Entry Arguments 



Reorganize Disk Directory 

I 

I CL = 42 

I DL = disk drive: 

I for drive A 

I 1 for drive B 

I : 

I 15 for drive P 



Returned Value 




P££££ipJfciojj_ 



if successful 
-1 if disk write-protected 
or has files open 



Explanation 



The Reorganize Disk Directory function reorg- 
anizes the directory on the disk drive speci- 
fied in register DL. If the hashed-directory 
flag bit in the volume label has been 
changed, this function will convert a hashed 
directory into linear format (or vice versa). 
The principal purpose of this function is to 
support the FIXDIR command. 

NOTE: In certain cases, this function may 
take a very long time to complete (possibly 
hours), and cannot be interrupted once in- 
voked. 
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(Intentionally left blank.) 
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TASM ASSEMBLER 



The TASM assembler is a two-pass relocatable 
assembler for 8086-famiiy microprocessors* 
intended for use in conjunction with the 
TurboDOS linker (TLINK). 



Operating 

AUSbl.UVbX« 



IS 



The assembler is invoked with the following 
command • 



I TASM sourcefn {objectfn} {-options} 



The "sourcefn" argument identifies an ASCII 
text file containing one or more assembly 
language source modules. If "sourcefn" does 
not contain an explicit type, the default 
type .A is assumed. 

The "objectfn" argument specifies the name of 
the object file to be created by TASM in the 
relocatable format required by TLINK. If 
"objectfn" does not contain an explicit type, 
the default type .0 is used. If "objectfn" 
is omitted from the command altogether, the 
object file is given the same name as the 
source file except that type .0 is used. 

Options are always preceded by a "-" prefix, 
and may appear before, between, or after the 
file names. Several options may be concate- 
nated after a single "-" prefix. 



Option J w£xj2laaajticjx 



-C 

-E 
-L 
-S 
-U 
-X 
-1 



List to console, not to printer 
Allow archaic equates "- 



W — 



Listing only, no object file 
Produce sorted symbol table 
Produce unsorted symbol table 
List only source lines in error 
Allow 80186 instructions 
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Lexical Conventions 



Names 



Keywords 



A name is composed of upper case letters A-Z, 
lower case letters a-z, digits 0-9, and the 
underscore "_" character. The first charac- 
ter of a name may not be a digit. Upper and 
lower case letters are treated as different 
characters. Names may be of any length, but 
only the first eight characters are signifi- 
cant. 



The size specifiers BYTE and WORD, and the 
machine registers AL, BL, CL, DL, AH, BH, CH, 
DH, AX, BX, CX, DX, SP, BP, SI, DI, CS, DS, 
SS, and ES are reserved as keywords, and may 
not be used otherwise. Keywords may be 
spelled in upper or lower case. 



Location Counter 



The special symbol period "." represents the 
location counter value at the start of the 
current instruction, and may be used in ex- 
pressions wherever a name would be appro- 
priate. For example: 



JMP 



;an infinite loop 



Numeric Constants 



Only integer constants up to a significance 
of 16 bits are permitted. A sequence of 
digits is normally interpreted as an unsigned 
decimal constant. However, a sequence of 
digits with a leading is taken to be an 
octal constant (in which the digits 8 and 9 
are invalid). A sequence of digits preceded 
by Ox (or OX) is taken to be a hexadecimal 
constant. Hexadecimal digits include the 
digits 0-9 and the letters A-F (which may be 
upper or lower case). 
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Character Constants A character constant is a single ASCII char- 
acter enclosed in apostrophes, as in ! x ! . 
The value of a character constant is the 
numerical value of the character expressed in 
seven-bit ASCII code. Certain non-graphic 
characters, the apostrophe and the backslant 
may be represented in character constants 

auCOIuxay tu uac iCiiuwiu^ uauxc wj. SSCafc 

sequences: 



1 ,. &SCIJ^£haxasJteJL-.. 


_J— 


_££P££££Jj£aJUe:n — 


1 line feed 




\n 


1 horizontal tab 




\t 


1 back space 




\b 


1 carriage return 




\r 


1 form feed 




\f 


1 apostrophe 




V 


1 backslant 




\\ 


1 null character 




\0 


1 any octal code 




\ddd 



The escape sequence \ddd consists of the 
backslant followed by 1, 2 or 3 octal digits 
that specify the ASCII code value of the 
desired character. 



Strings 



A string is a sequence of characters surroun- 
ded by quotes, as in "string". In a string, 
the quote character may be represented by the 
escape sequence \" and all of the escape 
sequences described for character constants 
may be used as well. No implicit string 
terminator is implied; if a null-terminated 
string is desired, it must be written as 
"string\0". 
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White Space White space (spaces and tabs) may be used 

freely between tokens, but not within names, 
keywords or constants. White space is re- 
quired to separate adjacent names, keywords 
or constants that are not separated by punc- 
tuation (for instance, between an instruction 
and its operands). 

Blank lines are always ignored, and may be 
used freely anywhere. 



Comments Comments are introduced by a semicolon ";" 

and continue until the end of the line. 
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Expressions 



An expression is a sequence of names, con- 
stants- Operators and i^afai^+^acsoe 4-Via+- pan ha 

evaluated to yield a value. The order of 
evaluation is determined by the precedence 
and associativity of operators, unless expli- 
citly overridden with parentheses. 



Unary Operators 



The following unary prefix operators are 
permitted in expressions: 



LfiPSJESicjCi.^. 



two's complement (negate) 
one's complement 
logical not 



The unary operators have higher precedence 
than any binary operator, and are evaluated 
right-to-left. (For example, -~0 yields 1, 
while ~-0 yields -1.) 

The logical not operator "I" yields a result 
of 1 (true) if its operand is false (zero), 
and a result of (false) if its operand is 
true (nonzero) . 
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'-t'-lr -V » ' ili ' i » ' .» i V n .V.I.' I. 



Binary Operators 



The following binary infix operators are 
permitted in expressions: 



LQpejca.tgJ.~L. 


Explanation 


1 * 


multiply 


1 / 


divide 


1 % 


modulus 


1 + 


add 


1 - 


subtract 


1 .» 


shift right 


1 << 


shift left 


1 < 


logical less-than 


1 > 


logical greater-than 


1 == 


logical equal-to 


1 & 


bitwise and 


i ** 


bitwise exclusive-or 


1 1 


bitwise inclusive-or 


1 && 


logical and 


1 1 1 


logical or 


1 —- «w.»-wu^w.^w.*. 


»«^*W»«-«h»«^«^»«!-.-:»«!WJ-.»»WWW«i«-»» 



Logical operators yield a result of 1 (true) 
or (false). The logical connectives && and 
I I treat their operands as true (if nonzero) 
or false (if zero). 

The precedence of binary operators is shown 
below, with each line representing a lower 
precedence than the line above it: 



highest 



lowest 



* 


/ 


+ 


- 


>> 


<< 


< 


> 


& 


A 


&& 


1 1 







Binary operators of equal precedence are 
evaluated left-to-right. (For example, 5-4+3 
yields 4.) 
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Relocatable 
Expressions 



All operators other than add (+) and subtract 
(-5 require absolute (non-relocatable) oper- 
ands and yield an absolute result. 

The addition operator (+) may be used to add 
a relocatable operand to an absolute operand, 
yielding a relocatable result with the same 
relocation base as the relocatable operand. 

The subtraction operator (-) may be used to 
subtract an absolute operand from a reloca- 
table operand, yielding a relocatable result 
with the same relocation base as the reloca- 
table operand. Further, the subtraction 
operator may be used to take the difference 
between two relocatable operands with the 
same relocation base, yielding an absolute 
result. 



External 
Expressions 



A name may be declared to the assembler as 
external (defined in some other module) by 
appending the suffix "#" at the end of each 
reference to the name. Such an external name 
reference is a relocatable value. The rules 
for addition and subtraction of relocatable 
values apply to externals as well: 



BUPFER#-1 ; valid: rel-abs 
BUFFER#+0xl0 ; valid: rel+abs 
BEG#+LEN# ; invalid: rel+rel 
END#-BEG# ; invalid: rel-rel 



The last case above is invalid because each 
different external name is treated by the 
assembler as a different relocation base. 
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Statements 



An assembler statement consists of the 
following elements in the specified order: 



1. a label 

2. one or more instruction prefixes 

3. an instruction or assignment 

4. one or more operands 

5. a comment 






All of these elements are optional, although 
items 2 and 4 must be omitted if item 3 is 
omitted. A label must be followed by a colon 
":" or an assignment operator. Multiple 
operands must be separated by commas. A 
comment must be introduced by a semicolon. 



Labels 



A statement may start with a label, which 
consists of a name followed by a colon ":", a 
double-colon "::", or an assignment operator. 
A double-colon indicates that the label is 
public (may be referenced by other modules). 
The label is normally given the current value 
of the location counter (exception: the label 
on an assignment or EQU statement). 

If a label has two leading underscore charac- 



ters, such as 



.LP:", it is considered to be 



a local label with scope limited by the pre- 
ceding and following non-local labels. This 
allows the same local label to be re-used 
many times within a module without ambiguity 
or conflict. 
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Assignments 



A name may be assigned any desired value by 
usin n a double— equals S = = B as an assignment 
operator: 



I TRUE 
I CR 
i VAR 



BYTE OxOD 
WORD -4lBP3 



or (equivalently) by using the EQU pseudo- 
instruction with a label: 



TRUE: 

CR: 

VAR: 



EQU 
EQU 
EQU 



BYTE OxOD 
WORD -4[BP] 



The defining expression (at the right of the 
assignment or EQU) may be absolute, reloca- 
table or external, but may not contain any 
forward references. Note that the name is 
assigned the size (BYTE or WORD) and address- 
ing mode (indexed or immediate) as well as 
the value and relocation characteristics of 
the defining expression. So, for example: 



TABLE 



MOV 
MOV 



BYTE -8EBP] 

TABLE [SI] ,=0 
BYTE -8tBP+SI] ,=0 



The two MOV instructions in the above example 
are identical. 
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Assignments 
(Continued) 



To make an assignment public, use the assign- 
ment operator "==:", or use a double-colon 
label with the EQU pseudo- instruction: 



I LENGTH ==: 66 ;LENGTH is public I 
I WIDTH:: EQU 132 ;WIDTH is public I 

NOTE: Invoking TASM with the "-E" option 
causes the assembler to accept t-ne--ax-cha-ic- 
assignment operators "=" and "=:" as synonyms 
for "= = " and "==:". These archaic forms are 
not recommended, however, because of syntac- 
tic ambiguities with the use of "=" as the 
immediate-addressing operator. 



Prompted 
Assignments 



An assignment statement with a string operand 
causes the assembler to display the given 
string as a prompt (followed by a colon and a 
space) and to accept a new operand from the 
console (or do-file) when the statement is 
encountered during the assembler's pass one: 



"Debug code? (0=no, l=yes) " 
"Number of buffers (1-16)" 
"Drive letter ( , A I ... , P , ) H 
"Enter version number" 



1 DEBUG 


= == 


1 BUFSIZ 


— mm m 


1 DRIVE : 


EQU 


1 VERS : : 


EQU 



In response to such a prompt, the assembler 
will accept any valid expression that would 
be legal in a non-prompted assignment. If 
the expression entered is not valid, the 
assembler asks that it be re-entered. 
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Instruction 
Prefixes 



A machine instruction may be preceded by a 
segment-override prefix (CS, DS, SS or ES), a 

ranaaf nrcf 1 v fDVD 'D1?T3T? DPD7 DWDXTI? <i v 

I. VfbUb f 4 * ,i - *■ ■*• ** \XV*J * , Zx.UIA.J_lf 1\U 1. U f XMJ.lllJ VJ. 

REPNZ), the prefix LOCK, or a combination of 
these. For example: 



REP MOVS BYTE ? repeat until CX=0 ! 
LOCK CS MOV BX,RTN ;RTN in CS-segment I 

I 

Alternatively, each prefix may appear as a 
separate statement : 



LOCK 

CS 

MOV 



BX,RTN 



;lock prefix 
;seg-override 

;prefixed instr. 



Note that segment-override prefixes must 
always be given explicitly, as the assembler 
never qenerates them imolicitlv. 



Instructions 



The instruction part of a statement may be 
either a symbolic machine instruction or a 
pseudo- instruction. Instructions and pseudo- 
instructions may be spelled in upper or lower 
case. 
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Addressing Modes 



Expressions are presumed to represent direct 
memory addresses unless immediate or indexed 
addressing is explicitly indicated. The 
equals-sign "=" may be used as a prefix to 
indicate that an immediate value is intended: 



I MOV AX, =0x1000 
I MOV AX, 0x1000 



;loads value 0x1000 
;loads word at DS:1000 



If an address is intended to be used as an 
immediate operand, the ampersand "&" prefix 
may be used to indicate "address of": 



MOV AX,&BUFFER 
MOV AX, BUFFER 



; loads addr of BUFFER 
; loads word at BUFFER 



Actually, the effect of the immediate-ad- 
dressing prefixes "=" and "&" is identical 
except that the "&" prefix discards any size- 
attribute which the prefixed expression may 
have, while the "=" prefix does not. 

An indexing expression enclosed in brackets 
"[...]" may be used to indicate that an 
indexed addressing mode is intended: 



MOV AX, [BX] 

MOV AX,[BX+SI3 

MOV AX,-4[BP] 

MOV AX, BUFFER [BX] 



;addr=(BX) 
;addr=(BX)+(SI) 
;addr=(BP)-4 
;addr=BUFFER+(BX) 
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Operand Size 



Many 8086-family data manipulation instruc- 
tions can operate on either bytes or words. 
F^r most such instructions- the assembler can 
determine implicitly whether to generate a 
byte or word instrution: 



MOV AX,=0 
MOV AL, = 
PUSH VALUE 



;word (AX is word-length) I 
;byte (AL is byte-length) i 
;word (can't PUSH a byte) I 



However, it is necessary to specify the oper- 
and length explicitly with the keyword BYTE 
or WORD if the assembler cannot otherwise 
determine it: 



MOV 
MOV 
MOV 
MOV 
MOV 



BYTE -4[BP] , = 
WORD -4[BP] ,=0 
-4fBP] ,WORD =0 
-4[BP] ,=WORD 
DL,WORD -4EBP] 



;byte 

;word 

;same as above 

;ditto 

; invalid 



The last example is invalid because the size 
attributes of the source (WORD) and destina- 
tion (BYTE) operands clash. 
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Pseudo- Instructions 

Module 
Identification 



The pseudo-instruction MODULE defines the 
module identification that appears at the top 
of each TASM listing page and in the in the 
TLINK module map. The module identification 
must be enclosed in quotes: 



MODULE "MAINPROG" 



;module ident 



and is truncated to 8 characters if a longer 
identification is specified. 



Linker Control 



The pseudo- instruction TLINK specifies one or 
more TLINK option letters enclosed in quotes: 



TLINK 



'HX n ; force TLINK -H and -X opt 



and causes those options to be in effect 
whenever the module is processed by TLINK. 



Location Counter 



The pseudo-instruction LOC (or ORG) sets the 
assembler's location counter to the value of 
its operand. The operand may be any valid 
absolute, relocatable or external expression, 
but it must not include forward references: 



LOC 
LOC 



0x100 
Code# 



; absolute 
;external 



If the operand is absolute, the assembler 
will assign absolute addresses to the code 
and data statements which follow, starting 
with the given absolute address. 
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Location Counter 
(Continued) 



If the operand is relocatable (generally an 
external name reference), the assembler will 
assign relocatable addresses relative to the 
relocation base of the operand. A relocation 
base may be any external name, but the fol- 
lowing special names are recognized by TLINK: 



LOG 


Code! j 


>code segment 


LOC 


Data* , 


?data segment 


LOC 


Extra* j 


•extra segment 


LOC 


Stack* j 


•stack segment 



Note the initial upper-case letter followed 
by lower-case letters (remember, case is 
significant in TASM names) . 

The pseudo-instruction RELOC (or REORG) 
restores the location counter to the value it 
had just prior to the preceding LOC (or ORG) : 











LOC 


Code* ;code segment 1 


1 START: 


MOV 


BX, TABLE 1 




MOV 


CX,=TABLEN 1 


1 L: 


CALL 


SUBRTN 1 




INC 


BX 1 




LOOP 


L ! 




RETF 






LOC 


Data* ;data segment 1 


1 TABLE : 


BYTE 


3,5,7,11,13,17 1 


1 TABLEN 


== 


.-TABLE 1 




RELOC 


;code seg again 1 


1 SUBRTN: 


... 






RET 





Note above the "RELOC" statement could be 
replaced by a second "LOC Code*" (entirely 
equivalent) . 
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Data Definition 



The pseudo- instruction BYTE (or DB) generates 
one or more byte-length data values: 



BYTDAT: BYTE 
BYTE 



ZZZ, 4*X, WORD ALPHA 
"Hello\r\n\0" 



The label (if present) is given the BYTE 
size-attribute. A string operand generates 
one byte for each character in the string. 
An operand with an explicit size-attribute 
WORD generates a word of data. All other 
operands generate a byte of data. 

The pseudo-instruction WORD (or DW) generates 
one or more word-length data values: 



WRDDAT: WORD 
WORD 



I 

ALPHA, 234*BETA, BYTE 5 I 
"What's the good word\0" I 



The label (if present) is given the WORD 
size-attribute. A string operand generates 
one byte for each character in the string. 
An operand with an explicit size-attribute 
BYTE generates a byte of data. All other 
operands generate a word of data. 

The pseudo-instruction RES (or RS) causes a 
specified number of bytes or words to be 
reserved without initialization: 



BLOCK: RES 0x100 ; reserve 256 bytes 
BBLOCK: RES BYTE 64 ; reserve 64 bytes 
WBLOCK: RES WORD 64 ; reserve 64 words 
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Data Definition 
(Continued) 



End of Module 



If the operand of a labelled RES statement 
has an explicit size-attribute (BYTE or 

attribute. If the operand has an explicit 
WORD size-attribute, then the statement 
reserves the specified number of words; 
otherwise, it reserves the specified number 
of bytes. 

The pseudo-instruction ALIGN causes the next 
generated item to be word-aligned (that is, 
assigned an even-numbered address) : 



ALIGN 

WRDDAT: WORD GAMMA ; word-aligned 

BYTE OMEGA 

ALIGN 

RES WORD 48 ; word-aligned 
STACK 



ALIGN is most frequently used before WORD or 
RES statements. 



The pseudo-instruction END terminates a 
module, and may have an optional operand that 
specifies a program starting address: 



MODULE "ALPHA 1 



START: 



END 



START 



An assembler source file may contain multiple 
modules. Each module is terminated with an 
END statement. The END statement following 
the last module in the file is optional (but 
recommended) . 
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Pre- Processor 
Directives 



J !«' l'||1 >' n' nU^ni'n i'a< l»1 !»'* 



Pre-processor directives differ from state- 
ments in that (1) they always start with a 
number-sign "#" prefix, (2) they may not have 
a label, and (3) they do not appear in the 
assembler listing. 



Listing Control 



Listing Format 



The #NOLIST directive prevents succeeding 
statements from appearing in the assembler 
listing. The #LIST directive re-enables 
listing after a tNOLIST. 

The #RELIST directive restores the listing 
mode that was in effect just prior to the 
last #LIST or #NOLIST directive. Nesting is 
not permitted. 



The #PAGE directive may take three forms: 



#PAGE 
#PAGE 
#PAGE 



width, length 
width 



;set width+length 
;set width only 
; start a new page 






The first two forms change the page width and 
length used for the assembler listing from 
their default values of 80 columns/line and 
66 lines/page. The last form (with no oper- 
ands) forces the start of a new listing page. 

The following directives: 



♦TITLE "Title of this module" 
#SUBTTL "Sub- title of this module" 



cause the specified strings to be used as a 
title or subtitle at the top of each page of 
the assembler listing. 
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File Inclusion 



Conditional 
Assembly 



A directive of the form: 



I # INCLUDE "filename" 



causes the entire contents of the specified 
source file to be included at that point in 
the source program. The file name must be 
enclosed in quotes. If no file type is 
specified, the default type .A is assumed. 
If no drive is specified, then the drive of 
the original "sreefile" argument from the 
TASM command line is assumed. #INCLUDE 
directives may be nested. 



Conditional assembly is achieved by using the 
following directives: 



#IF expression 

... 
#ELSE 
... 
#ENDIF 



The #IF~expression must yield an absolute 
value and must not contain forward referen- 
ces. If the expression evaluates to true 
(nonzero), any lines between the #ELSE and 
the #ENDIF are ignored by the assembler. If 
the expression evaluates to false (zero), any 
lines between the #IF and the #ELSE (or the 
#ENDIF if there is no #ELSE) are ignored. 
#IF-#ELSE-#ENDIF sequences may be nested. 



A-19 



TurboDOS 1.4 8086 
Programmer's Guide 



TASN ASSEMBLER 

Pre-Proc. Directives 
(Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Repetition 



The directives: 



♦REPEAT expression 

• • • 
#ENDREP 



cause any lines between the tREPEAT and 
#ENDREP directives to be repeated the number 
of times specified by the #REPEAT-expression. 
The expression must not contain forward ref- 
erences, and must evaluate to an absolute 
positive value between 1 and 32,767. Other- 
wise, the #REPEAT directive is diagnosed and 
a repeat-factor of one is assumed by the 
assembler. #REPEAT-#ENDREP may be nested. 



Macro Definition TASM does not support macros (yet). 
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Machine 
Instructions 



This section lists all machine instructions 
known to the assembler, together with the 

^Trriae ^\-F nr\«ran/le 4-V>«tt it g&mt A v a T n a 4- ir n r* 4- A r\r\ a 

marked "*" are 80186 instructions, and are 
diagnosed by the assembler unless the "-1" 
option is specified. 



1 , Jnstr t , j 


„QS£LaQ&M L 


, , . £ZEl&X&£i9Q 1 


1 AAA 




ASCII adj add 1 


1 AAD 




ASCII adj div 1 


1 AAM 




ASCII adj mult 1 


1 AAS 




ASCII adj subtr 1 


1 ADC 


reg, r eg/mem 
reg/mem, reg 
reg/mem, =immed 


add with carry 1 


i ADD 


reg,reg/mem 
reg/mem, reg 
reg/mem,=immed 


add 1 


1 AND 


reg, r eg/mem 
reg/mem, reg 
reg/mem, =immed 


and logical 1 


1 BOUND* 


req,mem 


bounds check 1 


1 CALL 


label 


call near I 


1 CALLF 


label, para 


call far 1 


1 CALLFI 


reg/mem 


call far indir I 


1 CALL I 


reg/mem 


call near indir 1 


1 CALLIF 


reg/mem 


call far indir 1 


1 CBW 




convert byte/wd 1 


1 CLC 




clear carry 1 


1 CLD 




clear direction 1 


1 CLI 




clear interrupt 1 


1 CMC 




complemnt carry 1 


1 CMP 


reg, reg/mem 
reg/mem, reg 
r eg/mem , = immed 


compare 1 


1 CMPS 


BYTE/WORD 


compare string 1 


1 CWD 




convert wd/dblw 1 


1 DAA 




decimal adj add 1 


1 DAS 




decimal adj sub 1 


! DEC 


reg/mem 


decrement 1 


1 DIV 


reg/mem 


divide 1 


• «3— .W— »-*— -^- •—- ^ ' -^W-l - W— — ►— . 


•*- .—*:-•.-. ;-^-«— *w- Mwmm«m - ' 
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Machine 

Instructions 

(Continued) 




ENTER* 

ESC 

HLT 

IDIV 

IMUL 



IN 

INS* 

INC 

INT 

INTO 

IRET 

JA 

JAE 

JB 

JBE 

JC 

JCXZ 

JE 

JG 

JGE 

JL 

JLE 

JMP 

JMPF 

JMPFI 

JMPI 

JMPIF 

JMPS 

JNA 

JNAE 

JNB 

JNBE 

JNC 

JNE 

JNG 

JNGE 



=frame,=nest 
const ,r eg/mem 

reg/mem 

r eg /mem 

reg,=immed* 

r eg, r eg/mem, * 

accum, const 

accum,DX 

B¥TE/WORD,DX 

reg/mem 

const 



label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label, para 

reg/mem 

reg/mem 

reg/mem 

label 

label 

label 

label 

label 

label 

label 

label 

label 



enter procedure 

escape 

halt 

integer divide 

integer multply 



immed* 

input 



input string 
increment 
interrupt 
interrupt o'flo 
interrupt ret'n 
jump if above 
jump if abv/eq 
jump if below 
jump if blo/eq 
jump if carry 
jump if CX=0 
jump if equal 
jump if greater 
jump if grtr/eq 
jump if less 
jump if less/eq 
jump near 
jump far 
jump far indir 
jump near indir 
jump far indir 
jump short 
jump not above 
jump not abv/eq 
jump not below 
jump not blo/eq 
jump not carry 
jump not equal 
jump not greatr 
jump not gtr/eq 
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Machine 


. Jnstrt . J 


___.J2p.ejC3DJ3£~ I. 


ExplanatlQn 1 


Instructions 1 










(Continued) i 


JNL 


label 


jump 


not less i 




JNLE 


label 


jump 


not les/eq 1 




JNO 


label 


jump 


not o'flo 1 




JNP 


label 


jump 


not parity 1 




JNS 


label 


jump 


not sign 1 




JNZ 


label 


jump 


not zero 1 




-rr\ 


label 


-i ■ ■ 1*. >~L 


U aUIa 1 




UU 


J UUI£/ 


xx. yj J.J.V/ i 




JP 


label 


jump 


if parity 1 




JPE 


label 


jump 


if pty evn 1 




JPO 


label 


jump 


if pty odd 1 




JS 


label 


jump 


if sign 1 




JZ 


label 


jump 


if zero 1 




LAHF 




load 


AH=flags 1 




LDS 


reg,reg/mem 


load 


ptr w/DS 1 




LEA 


reg, reg /mem 


load 


efctv addr 1 




LEAVE* 




leave procedure 1 




LES 


reg,reg/mem 


load 


ptr w/ES 1 




LOCK 




lock 


prefix 1 




LCDS 


BYTE/WORD 


load 


string 1 




LOOP 


label 


loop 






LOOPE 


label 


loop 


while eq 1 




LOOPNE 


label 


loop 


while neq i 




LOOPNZ 


label 


loop 


while nonz 1 




LOOPZ 


label 


loop 


while zero 1 




MOV 


reg, r eg/mem 
reg/mem, reg 
r eg/mem, = imme d 
seg, reg/mem 
reg/mem, seg 


move 






MOVS 


BYTE/WORD 


move 


string 1 




1 MUL 


reg/mem 


mult] 


Lply 1 




1 NEG 


reg/mem 


negate 1 




1 NOP 




no operation 1 




1 NOT 


reg/mem 


logical not 1 




1 OR 


reg, reg/mem 


logical or 1 






reg/mem, reg 










r eg/mem , = immed 








1 OUT 


const, accum 


output 1 






DX,accum 








I OUTS* 


DX, BYTE/WORD 


output string 1 
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Machine 

Instructions 

(Continued) 





.■LL>-^^QifixiD^iTIIII 


pop 


ina.tj.pn,. 1 


POP 


r eg /mem 






seg 






POPA* 




pop all 1 


POPF 




pop flags 1 


PUSH 


r eg /mem 

seg 

dimmed* 


push 




PUSHA* 




push all 1 


PUSHF 




push flags 1 


RCL 


r eg/mem, -1 
r eg/mem , CL 
r eg/mem, = immed* 


rotate 


cy left \ 


RCR 


reg/memr^l 
r eg/mem, CL 
r eg/mem, » immed* 


rotate 


cy right 1 


REP 




repeat 




REPE 




repeat 


while eq 1 


REPNE 




repeat 


while ne 1 


REPNZ 




repeat 


while nz 1 


REPZ 




repeat 


while z 1 


RET 


const 


return 


near 1 


RETF 


const 


return 


far 1 


ROL 


reg/mem,=l 
reg/mem r CL 
r eg/mem f = immed* 


rotate 


left 1 


ROR 


reg/mem,=l 
r eg/mem ,CL 
r eg/mem, = immed* 


rotate 


right 1 


I SAHF 




store AH=>flags 1 


1 SAL 


reg/mem r =l 


shift ar left 1 




r eg/mem , CL 








r eg/mem f = immed* 






1 SAR 


r eg/mem, =1 


shift ar right 1 




reg/mem f CL 








r eg/mem, dimmed* 






1 SBB 


reg,reg/mem 


subtract borrow 1 




reg/mem f reg 








r eg/mem, = immed. 






i . , - - , - . 
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Machine 
Instructions 

r*% j_j ji* 



1 jnstr, , I 


—^Qssxan&s I. 


JBJSPlADaJtiSJi 


i SCAS 


BYTE /WORD 


scan string 


1 SHL 


reg/mem,=l 
reg /mem, CL 
r eg/mem, = immed* 


shift left" 


1 SHR 


reg/mem,=l 
r eg/mem, CL 
r eg/ mem , — immed* 


shift right 


1 STC 




set carry 


1 STD 




set direction 


1 STI 




set interrupt 


1 STOS 


BYTE /WORD 


store string 


1 SUB 


reg,reg/mem 
reg/mem,reg 
r eg/mem , - immed 


subtract 


1 TEST 


reg, r eg/mem 
r eg/mem, reg 
r eg/mem , = immed 


test 


1 WAIT 




wait 


1 XCHG 


reg, r eg/mem 
reg/mem,reg 


exchange 


1 XLAT 




translate 


i XOR 


reg,reg/mem 
reg/mem,reg 


exclusive or 




r eg/mem, = immed 
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TLINK LINKER TLINK is a specialized linker used for 8086 

TurboDOS system generation, and may also be 
used as a general-purpose linker for object 
modules produced by the TASM assembler. 
TLINK links a specified collection of object 
modules together into a single executable 
file. 



Operation The linker is invoked with the following 

command : 



I TLINK inputfn {outputfn} {-options} I 

The "inputfn" argument identifies the two 
input files used by the linker: a configura- 
tion file "inputfn.GEN" and a parameter file 
"inputfn. PAR". The "outputfn" argument 
specifies the name of the executable output 
file to be created (normally type .CMD or 
.SYS). If "outputfn" is omitted from the 
command, then "inputfn" is also used as the 
name of the executable output file, and 
should include an explicit file type (.CMD or 
.SYS). 

If the .GEN file is found, it must contain 
the list of object modules (.0 files) to be 
linked together. If the configuration file 
is not found, then TLINK operates in an 
interactive mode. You are prompted by an 
asterisk * to enter a series of directives 
from the console. The syntax of each direc- 
tive (or each line of the .GEN file) is: 
( ^ , , | 

I objfile {,objf ile>. . . {;comment} I 
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Operation The object files are assumed to have type .0 

(Continued) unless a type is given explicitly. A null 

directive (or the end of the .GEN file) ter- 
minates the prompting sequence and causes 
processing to proceed. 

After obtaining the list of modules from the 
file or console, TLINK links all of the 
modules together, a two-pass process that 
displays the name of each module as it is 
encountered. When the linking phase is com- 
plete, TLINK looks for a parameter file 
"inputfn.PAR" and processes it if present 
(described below). Finally, the executable 
file (.CMD or .SYS) is written out to disk. 

NOTE: Each module of the TurboDOS operating 
system is magnetically serialized with a 
unique serial number. The serial number 
consists of two components: an "origin 
number" which identifies the issuing TurboDOS 
licensee, and a "unit number" which uniquely 
identifies each copy of TurboDOS issued by 
that licensee. When used for TurboDOS 
operating system generation, TLINK verifies 
that all modules to be linked are serialized 
consistently, and serializes the executable 
file accordingly. 
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Options 



Parameter File 



Options are always preceded by a "-" prefix, 
and may appear before, between, or after the 
file names. Several options may be concate- 
nated after a single "-" prefix. 



J2pJklsn_i~. 

-8 
=B 
-C 
-D 
-H 
-L 
-M 
-R 
-S 
-U 
-X 



&&Plaj33£ifi£- 



Force 8080 model (single group) 

No 12 8-byte base page 

List to console, not to printer 

Force data group G-Max to 64K 

No .CMD header (implies -8, -B) 

Listing only, no output file 

List link map 

List inter-module references 

List sorted symbol table 

List unsorted symbol table 

Diagnose undefined references 



TLINK includes a symbolic patch facility that 
may be used during TurboDOS system generation 
to override various operating system para- 
meters and to effect necessary software cor- 
rections. Symbolic patches must be stored in 
a .PAR file which may be built using any text 
editor. The syntax of each .PAR file entry 
is: 



I location - value {, value}... {; comment) I 






where the "value" arguments are to be stored 
in consecutive memory locations starting with 
the address specified by "location". 

The "location" argument may be the name of a 
public symbol, an integer constant, or an 
expression composed of names and integer 
constants connected by + or - operators. 
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Parameter File 
(Continued) 



Integer constants must begin with a digit to 
distinguish them from names. Constants of 
the form "Oxdddd" are taken to be hexadeci- 
mal. Constants of the form "Odddddd" are 
taken to be octal. Constants that start with 
a nonzero digit are taken to be decimal. The 
"location" expression must be followed by an 
equal-sign = character. 

The "value" arguments may be expressions (as 
def ined above ) or quoted ASCI I str ings, and 
must be separated by commas. A "value" ex- 
pression is stored as a 16-bit word if its 
value exceeds 255 or if it is enclosed in 
parentheses (...) or brackets [...]; other- 
wise, it is stored as an 8-bit byte. An 
expression enclosed in brackets is treated as 
a IP-relative word (for example, the target 
address of a JMP or CALL instruction). A 
quoted ASCII string must be enclosed by 
quotes "...", and is stored as a sequence of 
8-bit bytes. Within a quoted string, ASCII 
control characters may be specified by using 
backslant escape sequences (as described in 
the section on TASM). 



Error Messages 



Serial number violation 

Not enough memory 

No object files specified 

Can't open object file 

Unexpected EOF in object file 

Bad token in object file: <type> 

Can't create output file 

Can't write output file 

Load address out-of-bounds 

Duplicate transfer address 

Duplicate def: <name> 

Undefined name: <name> 

Too many externals in module 

Name table overflow 
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TBDG DEBUGGER 



TBUG is an interactive debuging facility that 

nrftTT -J riac uarirme far«i 1 if idc nn^or flf) Rfi Tnrhft- 

DOS useful to programmers who have the need 
to debug or patch programs. 






Operation 



The debugger is invoked with one of the fol- 
lowing commands: 



TBUG 

TBUG filename 

TBUG "filename commandtail" 



The first form simply invokes the debugger. 
The second form also causes the specified 
program file to be loaded into memory (see 
the L-directive below); the named file must 
have a .CMD header. The third form loads the 
specified program and parses the given 
command tail (see the Z-directive below); in 
this form the enclosing quotes are required. 

TBUG operates in an interactive mode. You 
are prompted by an asterisk * to enter a 
series of directives from the console. The 
Q-directive (Quit) terminates TBUG. 

Following is a summary of TBUG directives: 



A - display memory in ASCII 

C - calculate hexadecimal sum/difference 

D - display memory in hexadecimal 

E - examine/alter memory contents 

F - fill memory block with constant value 

G - start execution, set breakpoints 

H - display "help" menu of directives 

I - input from specified input port 

L - load program from .CMD file 

M - move a memory block 
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Operation 
(Continued) 



- output to specified output port 

P - put ASCII text into memory 

Q - quit TBUG and return to TurboDOS 

S - save program to .CMD file 

T - trace in single-instruction mode 

U - un-assemble code into TASM mnemonics 

V - verify if two memory blocks are equal 

W - breakpoint on specified OS calls 

X - examine/modify machine registers 

Z - pa rse command 1 ine into base page 



Directive Syntax 



Each TBUG directive starts with a letter 
which specifies the action to be taken, and 
ends with a carriage return. The directive 
letter may be followed by one or more argu- 
ments (addresses, address ranges, values, 
file names, etc.) separated by commas or 
spaces. 



Memory Addresses 



Most TBUG directives require one or more 
memory addresses as arguments. Addresses may 
be entered in three alternative formats: 



BBBB:0000 base paragraph + offset 
RR:0000 segment register + offset 
OOOO offset only 



The first format consists of a hexadecimal 
segment base paragraph address BBBB plus a 
hexadecimal offset byte address OOOO. In the 
second format, the segment base is specified 
by naming one of the 8Q86-family segment 
registers CS, DS, ES or SS. In the third 
format, the segment base is not specified; 
TBUG assumes the base is CS for the G, T and 
U directives, and DS for other directives. 
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Address Ranges 



Some TBUG directives accept a memory address 

var»rf*a ac an a t n nmon 4- Z^rjrjr^gg £ein' 

entered in two alternative formats: 






star taddr , endaddr 
startaddr , Llength 



I _,'j< Jt _. t '.|| 4 I 



The first format specifies the range as a 
starting address and ending address, sepa- 
rated by a comma (or a space). The starting 
address may contain a segment base prefix 
(paragraph address or segment register name), 
but the ending address must not (it is as- 
sumed to have the same segment base as the 
starting address). 

The second format specifies the range as a 
starting address and a length (in hexadecimal 
bytes). The length must be prefixed with the 
letter "L" to indicate that it is a length 
rather than an ending address. 






Directives 

A-Directive 



The A-directive displays the contents of a 
block of memory in ASCII. The directive 
formats are: 



A 
A 
A 



address 
range 



The first format displays 128 bytes of memory 
starting from the last address previously 
displayed. The second format displays 128 
bytes of memory starting from the given ad- 
dress. The third format displays the given 
address range. 
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C-Directive 



D-Directive 



The C-directive displays the sum and dif- 
ference of two hexadecimal arguments. The 
directive format is: 



C valuel value2 






in response to 
hexadecimal sum 
arguments. 



which TBUG displays the 
and difference of the two 



The D-directive displays the contents of a 
block of memory in hexadecimal. The 
directive formats are: 



E-Directive 



D address 
D range 









The first format displays 128 bytes of memory 
starting from the last address previously 
displayed. The second format displays 128 
bytes of memory starting from the given ad- 
dress. The third format displays the given 
address range. 



The E-directive is used to examine and modify 
the contents of memory. The directive format 
is: 



E address 



TBUG displays the hexadecimal byte at the 
given address followed by an equals sign = 
and awaits keyboard input. 
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E-Directive 



F-Directive 



G-Directive 



If a hexadecimal value is entered, it is 
stored at that memor 17 locations If an equals 
sign = is entered, the memory location is 
left unchanged. In either case, TBUG 
continues to display successive memory 
addresses and values until a null response 
(RETURN only) is entered. 






The F-directive fills a block of memory with 
zeroes, or with a specified hexadecimal byte 
value. The directive formats are: 






F range 

F range value 



The first form fills every location in the 
given address range with zero. The second 
form fills every location in the range with 
the given byte value. 



The G-directive starts executing the loaded 
program, and optionally sets one or more 
breakpoint addresses. The directive formats 
are: 



G 
G 
G 
G 



^address 
breakpoint. . . 
=address breakpoint. 



The first format transfers to the starting 
address corresponding to the current values 
of the CS and IP registers. The second for- 
mat transfers to the given starting address, 
setting the CS and IP registers accordingly. 
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G-Directive The last two formats are similar to the first 
(Continued) two, except that up to ten breakpoint addres- 
ses are specified. If the program encounters 
any of the breakpoints, execution is inter- 
rupted just prior to the instruction at the 
breakpoint address, the address is displayed, 
all outstanding breakpoints are cancelled, 
and TBOG prompts for another directive. 

H-Directive The H-directive displays a help menu that 

lists all TBUG directives, each with its 
argument format and a brief description. 

I-Directive The I-directive inputs a byte from an input 

port. The directive format is: 



port 



where "port" is a hexadecimal input port 
address. A byte is input from the specified 
port and displayed in hexadecimal. 



L-Directive The L-directive loads a program into memory 

from disk. The directive format is: 



L filename {commandtail) 



If "filename" does not specify an explicit 
type, the default type .CMD is assumed. In 
any case, the file must start with a .CMD 
header. TBUG discards any previously loaded 
program, loads the specified .CMD file into 
memory, and initializes the base page, seg- 
ment registers and IP register. If a command 
tail is present, it is parsed and processed 
as described under "Z-Directive" below. 
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M-Directive 



The M-directive moves a block of memory to 
another location- The directive format is: 



M range address 






The block of memory specified by ^_ 

moved to the starting address specified by 
"address". 



O-Directive 



The O-directive outputs a specified byte 
value to a specified output port. The 
directive format is: 



P-Directive 



port value 



where "port" is a hexadecimal output port 
address and "value" is a hexadecimal byte 
value. The given value is output to the 
given port. 



The P-directive permits ASCII text to be 
entered from the console into memory. The 
directive format is: 



P address 



Q-Directive 



In response to this directive, TBUG accepts 
console input and stores each ASCII character 
into a successive memory location, starting 
at the given address. Entering an EOT 
character (CTRL-D) terminates the directive. 



The Q-directive is used to quit TBUG and 
return to TurboDOS. 
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S-Directive 



The S-directive saves the currently loaded 
program onto disk. The directive format is: 



S filename 



If "filename" does not specify an explicit 
type, the default type .CMD is assumed. The 
currently loaded program is saved on disk in 
.CMD format under the specified file name. 

Note that whenever TBUG loads a program into 
memory, it retains information about the 
segment structure of the loaded program. The 
S-directive uses this information to 
determine the program segment structure to be 
written to disk. 



T-Directive 



The T-directive traces program execution in 
single-instruction mode. The directive 
formats are: 



1 T 

1 T ^address 
1 T length 
1 T =address 


length 



The first format traces the instruction 
corresponding to the current values of the CS 
and IP registers. The second format traces 
the instruction at the given starting 
address, setting the CS and IP registers 
accordingly. The last two formats are 
similar to the first two, except that 
"length" specifies the hexadecimal number of 
instructions to be traced. 
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U-Directive The U-directive displays the contents of 

nisisot" "un~*assembled n in 
The directive formats are: 



rnomor" "un~assejflbi^<3" into tasm mnemonics. 



I U I 

j U =address I 

i U length I 

I U =address length I 

The first format displays the next 16 machine 
instructions, starting from the last address 
previously displayed. The second format 
displays the next 16 machine instructions, 
starting from the specified address. The 
last two formats are similar to the first 
two, except that "length" specifies the 
hexadecimal number of instructions to be 
displayed. 



V-Directive The V-directive verifies whether or not two 

blocks of memory are identical. The 
directive format is: 



I 

I V range address 



The block of memory specified by "range" is 
compared to the block of equal length start- 
ing at "address". Any discrepancies are 
diagnosed. 
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W-Directive 



The W-directive executes the loaded program 
in monitored mode, breaking on specified C- 
and T-funetion calls. The format is: 



W fen... 



X-Directive 



where up to ten "fen" arguments may be 
specified to trap specific TurboDOS function 
calls. Each "fen" argument may take one of 
the following forms: 



nn 

Tnn 

* 

T* 



(trap C-function nn hex) 
(trap T-function nn hex) 
(trap all C-functions) 
(trap all T-functions) 



Program execution starts at the location 
specified by the current CS and IP register 
values, and continues until one of the 
trapped functions is invoked by the program. 
Program termination is always trapped. 



The X-directive is used to display and alter 
the contents of machine registers. The 
directive formats are: 



X regname 



The fist format displays the contents of all 
machine registers. The second format dis- 
plays the contents of the specified register, 
and permits it to be altered by entering a 
hexadecimal value. Only word-length register 
names are accepted: AX, BX, CX, DX, SI, DI, 
BP, SP, IP, CS, DS, ES and SS. 
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Z-Directive The Z-directive sets up the default FCB and 

default record buffer in the base page of the 
currently loaded program according to the 
given command-tail parameters. The command 
format is: 



I I 

i Z command- tail i 



The command tail length and text are moved to 
the base page record buffer, and up to two 
filenames are parsed from the command tail 
and placed into the base page FCB. 
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TPC EMULATOR 



File Conversion 



The TPC emulator is a transient emulator for 
IBM Personal Computer DOS version 1.1. and 
allows many programs written for PC-DOS to 
be run under TurboDOS. The facility consists 
of two programs: a file conversion utility 
READPC.CMD and the emulator itself TPC.CMD. 

The file conversion utility READPC.CMD 
facilitates copying of program and data files 
from PC-DOS disks to TurboDOS disks. This 
conversion must be accomplished before the 
emulator may be used. The READPC command is 
syntactically similar to COPY: 



Emulation 



READPC srcefile destfile 



km^^mUmWWwW. 



Wild-cards may be used in the "srcefile" and 
"destfile" arguments. To ensure that the PC- 
DOS source disk is not accidentally corrupted 
by TurboDOS, it is advisable to set the 
source drive read-only with the SET command 
before invoking READPC. 



The emulator is invoked by the command: 



I TPC {PCcommand} 



If the "PCcommand" argument is present, it 
must consist of the name of a PC-DOS-format 
program file (type .COM or .EXE) possibly 
followed by a valid PC-DOS command tail. In 
this case, TPC executes the specified PC-DOS 
program under emulation, and returns to the 
TurboDOS command level when the program 
terminates. 
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Emulation If no "PCcommand" argument is given, TPC 

(Continued) operates in an interactive mode. You are 

prompted by the character "3" to enter a 
series of PC-DOS commands consisting of the 
name of a PC-DOS-format program file (type 
.COM or .EXE) possibly followed by a valid 
PC-DOS command tail. In response to each 
command, TPC executes the specified PC-DOS 
program under emulation, and prompts for 
another PC-DOS command when the program 
terminates. To terminate TPC and return to 
the TurboDOS command level, you must enter an 
attention/abort sequence at the TPC prompt. 

TPC emulates PC-DOS version 1.1 only; there 
is no support for hierarchical directories 
and the other UNIX-like extensions of PC-DOS 
version 2.0. Nearly all functions of PC-DOS 
version 1.1 are supported, with the excep- 
tions discussed in the next paragraph. 

Interrupts 24, 25 and 26 are not supported 
and result in program termination with an 
error message. Extended FCBs are allowed but 
the attribute byte in the extension is 
ignored. Function 27 (Return Allocation 
Table Address) and function 46 (Set/Reset 
Verify Switch) perform no operation. Func- 
tion 40 (Random Block Write) does not support 
the file size truncation option (CX«0). 

TPC.CMD contains several patch points. 
CS:0004 is the prompt character, CS:0005 is 
the comm channel used in emulating PC-DOS 
functions 3 and 4, and CS:0006 contains 
debugging flags. If flag bit .7 is set, TPC 
displays each emulated PC-DOS function as a 
decimal number. If bit 6 is also set, TPC 
then pauses until a RETURN is entered from 
the keyboard; during this pause, an "R" may 
be entered to display the CPU registers. If 
bit 5 is set, TPC executes a TBUG breakpoint 
just before jumping to the PC-DOS program. 
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I^Xe-i^fcrllJiBSilJSIbJJdfflSw^i. 



vff&SSSfl Vj |.,J 



;ygpefl r . 



s 
i o 


System Reset 


_ 


— 




! 


i i 


Console Input 


- 


AL 


= 


char 1 


I 2 


Console Output 


DL = char 


- 






1 3 


Raw Console Input 


- 


AL 


= 


char 1 


I 4 


Raw Console Output 


DL = char 


- 






i 5 


List Output 


DL = char 


- 






i 6 


Direct Console I/O 


DL = -l (inp/sta) 


AL 


= 


0/char 1 






DL = -2 (status) 


AL 


= 


0/-1 1 






DL = -3 (input) 


AL 


= 


char 1 






DL = char (output) 


- 






1 7 


Get I/O Byte 


- 


AL 


= 


I/O byte 1 


1 8 


Set I/O Byte 


DL = I/O byte 


- 






1 9 


Print String 


DS:DX = fcstring 


— 






1 10 


Read Console Buffer 


DS:DX = Sbuffer 


- 






1 11 


Get Console Status 


- 


AL 


= 


0/-1 1 


1 12 


Return Version . 


- 


BX 


=s 


0x0031 1 








DX 


ss 


net addr i 








ES 


= 


base of OS 1 


1 13 


Reset Disk System 


- 


- 






1 14 


Select Disk 


DL = drive (0=A) 


— 






1 15 


Open File 


DS:DX = &FCB 


AL 


= 


(-1 if err) 1 


1 16 


Close File 


DS:DX = &FCB 


AL 


= 


(-1 if err) 1 


1 17 


Search for First 


DS:DX = &FCB 


AL 


= 


(-1 if err) 1 


1 18 


Search for Next 


- 


AL 


as 


(-1 if err) 1 


I 19 


Delete File 


DS:DX = &FCB 


AL 


as 


(-1 if err) 1 


1 20 


Read Sequential 


DS:DX = &FCB 


AL 


= 


(NZ if err) 1 


1 21 


Write Sequential 


DS:DX = &FCB 


AL 


as 


(NZ if err) 1 


1 22 


Make File 


DS:DX = &FCB 


AL 


as 


(-1 if err) 1 


1 23 


Rename File 


DS:DX = &FCB 


AL 


ss 


(-1 if err) 1 


1 24 


Return Login Vector 


- 


BX 


=s 


vector 1 


1 25 


Return Current Disk 


- 


AL 


== 


drive (0=A) 1 


1 26 


Set DMA Address 


DS:DX = &DMA 


- 






1 27 


Get ALV Address 


(not supported) 


BX 


a= 


1 


1 28 


Write Protect Disk 


- 


- 






1 29 


Get R/O Vector 


- 


BX 


as 


vector 1 


1 30 


Set File Attributes 


DS:DX = &FCB 


AL 


as 


(-1 if err) 1 


1 31 


Get DPB Address 


- 


BX 


ss 


&DPB 1 


1 32 


Get/Set User Number 


DL = -1 

DL = user number 


AL 


as 


user number 1 


1 33 


Read Random 


DS:DX = &FCB 


AL 


sa 


(NZ if err) 1 



E-l 



TurboDOS 1.4 8086 
Programmer's Guide 



C-FUNCTION SUMMARY 
(Continued) 



Copyright 1984 by Software 2000 , Inc. 
All rights reserved. 



^■i> ' »m^ Mi»t ■«*■»* ■ 9 ■m'f »m~ ■■»! «V ii «1 ■ m ■»? ■ ■'<■■'■» w« < ■ a* ■«' **3 . 



W^Uw^W 


Write Random DS:DX = &FCB AL 




*s .Ret-Urneo I 


1 34 


= 


(NZ if err) 1 


1 35 


Compute File Size 


DS:DX = &FCB 


AL 


= 


(-1 if err) 1 


1 36 


Set Random Record 


DS:DX = &FCB 


- 






1 37 


Reset Drive 


DX = vector 


- 






1 40 


Write Random 0-Fill 


DS:DX = &FCB 


AL 


= 


(NZ if err) 1 


1 42 


Lock Record 


DS:DX = &FCB 


AL 


s: 


(NZ if err) 1 


1 43 


Unlock Record 


DS:DX = &FCB 


AL 


B 


(NZ if err) 1 


1 44 


Set Multi-Sector Ct 


DL = record count 


AL 


s 


1 


1 46 


Get Disk Free Space 


DL = drive (0=A) 


AL 


"as" 


1 


1 47 


Chain to Program 


(Cmd at 0x0080) 


- 






1 50 


Direct BIOS Call 


DS:DX = &BIOS Desc 


AX 


= 


BX = return 1 


1 51 


Set DMA Base 


DX = DMA base para 


- 






1 52 


Get DMA Address 


- 


ES: 


:BX = DMA addr 1 


1 53 


Alloc Max Memory 


DS:DX = &MCB 


AL 


as 


(-1 if err) 1 


1 54 


Alloc Abs Max Mem 


DS:DX = &MCB 


AL 


ss 


(-1 if err) 1 


1 55 


Allocate Memory 


DS:DX = &MCB 


AL 


as 


(-1 if err) 1 


1 56 


Alloc Abs Memory 


DS:DX = &MCB 


AL 


as 


(-1 if err) 1 


1 57 


Free Memory 


DS:DX = &MCB 


AL 


as 


(-1 if err) 1 


1 58 


Free All Memory 


- 


- 






1 59 


Program Load 


DS:DX = &FCB 


BX 


as 


BP para/-l 1 


1 104 


Set Date and Time 


DS:DX = &DTP 


- 






1 105 


Get Date and Time 


DS:DX = &DTP 


AL 


ss 


seconds/BCD ! 


1 107 


Return Serial Nbr 


DS:DX = &SN 


- 






1 108 


Get/Set Return Code 


DX = OxFFFF 
DX = retcode 


BX 


SS 


retcode 1 


1 110 


Get/Set Delimiter 


DX = OxFFFF 
DL = delimiter 


AL 


= 


delimiter I 


1 111 


Print Block 


DS:DX = &CCB 


- 






1 112 


List Block 


DS:DX = &CCB 


- 






1 134 


Make Queue 


DS:DX = &QD 


AL 


as 


(NZ if err) 1 


1 135 


Open Queue 


DS:DX = &QPB 


AL 


ss 


(NZ if err) 1 


1 136 


Delete Queue 


DS:DX = &QPB 


AL 


as 


(NZ if err) 1 


1 137 


Read Queue 


DS:DX = &QPB 


AL 


as 


(NZ if err) 1 


1 138 


Cond'l Read Queue 


DS:DX = &QPB 


AL 


as 


(NZ if err) 1 


1 139 


Write Queue 


DS:DX = &QPB 


AL 


as 


(NZ if err) 1 


1 140 


Cond'l Write Queue 


DS:DX = &QPB 


AL 


as 


(NZ if err) 1 


1 141 


Delay 


DX = tick count 


- 






1 142 


Dispatch 


- 


- 






1 143 


Terminate 


" 









E-2 



Programmer's Guide (Continued) 



Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



I . gfr.? . .[,„■ .■C7?tfOJgt.t.9P..-gCTg-.--.--k.^cgWgPtff .-Pfrgggfl 

■ t 

i i 

I 152 Parse Filename DS:DX = &PFCB BX = if EOL 

I -1 if error 

I else &delim 

I DX = &delim 

I 153 Get Console Number - AL = console no. 

i 155 Get Date and Time DSsDX « &DTP 

I 160 Set List DL = list dev. no. - 

I 161 Cond f l Attach List - AL = 
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1 

2 
3 

4 
5 

6 
7 
8 
9 



10 



11 
12 



13 
14 



15 
16 
17 

18 
19 



Reset O/S 
Create Process 

Delay Process 
Allocate Memory 

Deallocate Memory 
Send I/P Message 

Receive I/P Message 
Set Error Address 
Set Abort Address 
Set Date and Time 



Get Date and Time 




DX = &entrypoint 
BX = &workspace 
DX = tick count 
DX = length 

DX - Smemory 
DX = fcmsgnode 
BX = &message 
DX = &msgnode 
BX:DX = fcerrorcode 
BX:DX = fcabortcode 
BX = Julian date 
DH = hours 
DL = minutes 
CH = seconds 



Rebuild Disk Map 
Return Serial Nbr 



Set Compatability 
Log-On/Log-Off 



Load Pile 
Activate Do-File 
Dis/Enable Autoload 

Send Command Line 
Get Alloc Info 



DL = drive (A=0) 



DL = compatflags 
DX « OFFFFH (off) 
DH = -1/drive (on) 
DL = user nbr (on) 
(not supported) 
DS:DX = &FCB 
DL = (disable) 
DL = 1 (enable) 
DSLDX = Sbuffer 
DL = drive (0=A) 



AL = 0/-1 
BX ■ Smemory 



BX = &message 



BX 


= 


Julian Date 


DH 


SE 


hours 


DL 


= 


minutes 


CH 


ss 


seconds 


CL 


s 


tick count 


AL 


S 


0/-1 


BX 


= 


origin # 


DX 


= 


unit # 


CH 


as 


0x80 (priv) 


CL 


s 


0x13 vers'n 



AL = 0/-1 



AL = 
AL = 0/-1 



AL - block size 
CL = dir blocks 
DX « free blocks 
BX = tot. blocks 
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20 



26 
27 



28 
29 



30 



31 
32 
33 

34 
35 
36 



Get Physical Info 



21 Get/Set Drv Status 



22 Phys. Disk Access 

23 Set Buffer Params 

24 Get Buffer Params 



25 Lock/Unlock Drive 



Flush/Free Buffers 
Get/Set Print Mode 



Signal End-of-Print 
Get/Set Despool Mod 



Queue a Print File 



Flush List Buffer 
Network List Out 
Remote Console I/O 

Get Comm Status 
Comm Channel Input 
Comm Channel Output 



DL 


= 


drive (0=A) 


AL 


= 


sector size 








CX 


ss 


res. tracks 








DX 


ss 


tot. tracks 








BX 


S3 


sectors/trk 


DL 


ss 


drive (0=A) 


AL 


ss 


0/-1 


DH 


ss 


(set R/W) 








DH 


3 


1 (set R/O) 








DH 


ss 


-1 (get) 


BL 


ss 


-1 if ready 








BH 


ss 


-1 if R/O 


DS: 


DX = &PDR 


AL 


as 


0/-1 


DH 


= 


# of buffers 


- 






DL 


= 


buffer size 








- 






AL 


s= 


mem. size 








BH 


ss 


# buffers 








BL 


ss 


buffer size 


DL 


= 


drive (0=A) 


AL 


ss 


0/-1 


DH 


= 


(unlock) 








DH 


= 


-1 (lock) 








DL 


ss 


drive (0=A) 


- 






DH 


= 


subfunctions 








DL 


ss 


print mode 


AL 


ss 


spool drive 


DH 


ss 


printer/queue 


BH 


ss 


prntr/queue 


CH 


= 


spool drive 


BL 


= 


print mode 



DL = despool mode 
DH - queue assgnmt 
CH » printer 
DS:DX = &FCB 
BH = print queue 
BL = user#/delete 

DL = char 

DL = 0/char 

DH = -1 to attach 

DH = channel/rmt 

DH = channel/rmt 

DH = channel/rmt 

DL = char 



AL ■ 0/-1 



AL = 0/-1 



AL = 0/1/-1 



AL 
AL 



0/-1 
char 
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37 

38 
39 

40 
41 



Set Comm Baud Rate DH = channel/rmt 

DL = baudrate 
Get Comm Baud Rate DH = channel/rmt 
Set Modem Controls DH = channel/rmt 

DL - vector 
DH = channel/rmt 
CH = net routing 
BX & DX userdef 
DL = drive (0=A) 



Get Modem Status 
User-Defined Fen 



42 Reorg Disk Dir 



AL = baudrate 



AL = vector 
AL,BX-DX userdef 

AL - 0/-1 
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Access Manager Digital Research's Access Manager package 

runs under TurboDOS versions 1*40 and later* 
The modules MPMSUP and QUEMGR must be inclu- 
ded in the system generation. In addition r 
certain special procedures must be followed. 

The 8086 Access Manager background server 
AM86 is distributed in standard .CMD form, 
and may be used as-is. No special initiali- 
zation procedure is required (as with 8080 
Access Manager). 

One problem is that AM86 does not provide any 
means of terminating itself. Since AM86 
keeps queues open, it interferes with the use 
of the BUFFERS and CHANGE commands. One 
solution is to run AM86 in a slave, and to 
intentionally reset (crash) the slave when 
AM86 is no longer wanted. Even then, it may 
be necessary to manually delete the FIFOs if 
they were non-empty when AM86 was terminated. 

The QUEMGR module of TurboDOS contains a 
patchable symbol QUEDLY that determines the 
delay interval (in "ticks") between sampling 
of queues when they have become empty or 
full. QUEDLY defaults to zero (no delay). 
If an RTC driver is available, QUEDLY should 
be patched to the largest value that provides 
satisfactory performance. This will reduce 
dispatch overhead and network traffic load. 
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WordStar MicroPro's WordStar-36 word processor runs 

under TurboDOS versions 1.30 and later with- 
out modification. Operation in banked-memory 
systems is particularly attractive, since 
WordStar works best with lots of TPA. 

Concurrent editing and printing works best 
with spooled printing. The Attention/CTRL-L 
sequence is useful for initiating de-spooled 
printing without having to exit WordStar. 



Since WordStar-86 calls the MP/M Delay func- 
tion (C-function 141) which is supported by 
the TurboDOS MPMSUP module, it is essential 
to include either an RTC driver or RTCNUL in 
the system generation; otherwise, WordStar 
will hang. 
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INDEX 

$.DIR, 2-7 
$.DSK, 2-7 
8080 model, 1-2 

abort intercept, 3-4, 5-10 
activate do-file (T16) , 5=18 
all-inclusive lock, 4-43, 4-44 
allocate 

abs max memory (C54) , 4-53 

abs memory (C56) , 4-55 

max memory (C53) , 4-52 

memory (C55) , 4-54 

memory (T3) , 5-5 
allocation block size, 2-1 
allocation map, 2-2, 5-13 
allocation of memory, lr2 
application notes, G-l 
archived file attribute, 2-9 
ASCII files, 2-3 
assembler (TASM) , A-l 
attention requests, 3-4 
attributes 

file, 2-9, 4-34 

interface, 2-9, 4-18, 4-19 
autoload, 1—11, 5—19 

BACKUP command, 5-25, 5-28 
base page, 1-2, 1-12 
basic console I/O, 3-1 
basic print output, 3-6 
batch processing, 1-11 
baud rate, 5-40 
BDOS 

functions, 1-6 

version, 4-15 
BIOS parameter block, 4-48 
block size, 2-1 
BOOT command, 5-25 
BREAK, 3-4 

buffer management, 2-17, 5-26 
BUFFERS command, 1-2, 5-26 



C-function 

calling sequence, 4-1 

definition, 1-6 

summary of, E-l 
capacity of disks, 2-1 

nU 3 ; n 4-^ -r-Mrrm fr*A"7\ A_A*7 . A — £0 

wiiaxu bv £rj. wvj \vi iff -* -* > r ^ v *■ 

CHANGE command, 5-28 

changing media, 2-18, 5-29 

character control block, 4-64 

close file (C16) , 4-19 

code group, 1-2, 1-5 

cold-start, 1-11, 1-15 

COLDSTRT.AUT, 1-11 

comm channel 

get baud rate (T38) , 5-41 

get modem status (T40) , 5-43 

get comm status (T34) , 5-37 

I/O, 3-5 

input (T35) , 5-38 

output (T36) , 5-39 

set baud rate (T37) , 5-40 

set modem contrls (T39), 5-42 

command 

file, 1-2, 1-5, 4-58 

file header, 1-2, 1-5, 4-58 

format, 1-9 

parsing, 1-10 

processing, 1-9 

prompt, 1-9 

sending, 5-20 

strings, 1-10 

tail, 1-9 

compact model, 1-2, 1-4 

compatibility modes, 2-13, 5-15 

compute file size (C35) , 4-39 

Concurrent CP/M, 1-7 

conditional 

attach list (C161) , 4-81 
read queue (C138) , 4-70 
write queue (C140) , 4-72 

CONREM driver, 5-36 
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console 

I/O, 3-1 

identification, 3-3 

input (CD , 4-3 

output (C2) , 4-4 
CP/M-86, 1-6, 1-7 
CP/M compatibility, 1-6, 4-15 
CPMSUP module, 4-10, 4-11, 4-28 

4-32, 4-33, 4-41, 4-61 
create process (Tl) , 5-3 
CTRL-C, 3-4 
CTRL-L, 3-4 
CTRL-P, 3-4 
CTRL-Q, 3-4 
CTRL-S, 3-4 
current drive, 1-9 

data group, 1-2, 1-5 

deallocate memory (T4) , 5-6 

debugger (TBUG) , C-l 

default FCB, 1-13 

default record buffer, 1-14 

delay (C141) , 4-73 

delay process (T2) , 5-4 

delete file (C19) , 4-23 

delete queue (C136) , 4-68 

delimiter, 4-12, 4-63 

despool mode, 5-32 

direct BIOS call (C50) , 4-48 

direct console I/O (C6) , 4-8 

directory, 2-2 

directory formats, 2-3 

dis/enable autoload (T17), 5-19 

disk 

capacity, 2-1 

directory, 2-2 

organization, 2-2 

parameter block, 4-35 

specification table, 5-25 

system disk, 1-15 
dispatch (C142) , 4-74 
DMA address, 4-16, 4-30 
do-file, 1-11, 5-18 



drive letter, 2-6, 2-7 

emulator (TPC) , D-l 
end-of-print, 5-31 
error handling, 2-18 
error intercept routine, 5-9 
exclusive open mode, 2-11 
execution models, 1-2 
extra group, 1-2, 1-5 

FCB organization, 2»7 
FIFO file attribute, 2-9 
FIFO files, 2-15 
file 

attributes, 2-9, 4-34 

command, 1-2, 1-5, 4-58 

control block format, 2-7 

libraries, 2-10 

locks, 2-11 

names, 2-6, 2-7 

operations, 2-4 

organization, 2-3 

sharing, 2-10 

special ($.DIR/$.DSK) , 2-7 

system, 2-1 

type, 2-7 
FIXDIR command, 5-28, 5-45 
FIXMAP command, 5-13, 5-28 
floppy disks, 2-1 
flush list buffer (T31) , 5-34 
flush/free buffers (T26) , 5-29 
FORMAT command, 5-25, 5-28 
free all memory (C58), 4-57 
free memory (C57) , 4-56 



get 



ALV address (C27) , 4-31 
buffer params (T24), 5-27 
comm baud rate (T38) , 5-41 
comm status (T34) , 5-37 
console number (C153) , 4-78 
console status (Cll) , 4-14 
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get 

date and time (C105) , 4-60 
date and time (C155) , 4-79 
date and time (T10) , 5-12 
disk free space (C46) , 4-46 
DPB address (C31) , 4-35 
I/O byte (C7) , 4-10 
modem status (T40) , 5-43 
R/O vector (C29), 4-33 

get/set 

despool mode (T29), 5-32 
delimiter (C110) , 4-12, 4-63 
drive status (T21) , 5-23 
print mode (T27) , 5-30 
pgm return code (C108) , 4-62 
user number (C32) , 4-36 

global files, 2-9, 2-10, 2-14 

group descriptor, 1-5 

hard disks, 2-1 

hashed directory format, 2-3 

header (CMD file), 1-2, 1-5 

intercepting errors, 5-9 
intercepting aborts, 5-10 
interface attributes, 4-18 
interrupt vectors, 1-1 

label on volume, 2-2 

linear directory format, 2-3 

linker (TLINK) , B-l 

list block (C112) , 4-65 

list output (C5) , 4-7 

load file (T15) , 5-17 

loader (OSLOAD.CMD), 1-15 

lock record (C42) , 4-43 

lock/unlock drive (T25) , 5-28 

locks 

file, 2-11 

record, 2-12 
log-on/log-off (T14) , 5-16 
logical compatibility, 2-14 



make file (C22) , 4-26 

make ^ueue (C1343 , 4—66 

map, 2-2, 5-13 

MASTER command, 5-36 

master operating system, 1-15 

media changes, 2-18, 5-29 

memory 

allocation, 1-2 

control block, 4-52, 4-53, 
4-54, 4-55, 4-56 

organization, 1-1 
message node, 5-7, 5-8 
mixed-mode compatibility, 2-14 
model 

8080, 1-2 

compact, 1-2, 1-4 

small, 1-2, 1-3 
modem controls, 5-42 
modem status, 5-43 
MP/M-86, 1-7, 2-13 
MPMSUP module, 4-66 to 4-75, 

4-78 to 4-81 
MS-DOS emulator (TPC) , D-l 
multi-sector count, 4-45 

naming files, 2-6 

network list out (T32) , 5-35 

non-privileged, 2-10, 4-36 

open file (C15) , 4-18 
open modes, 2-11, 4-18 
open queue (C135) , 4-67 
operating system 

master (OSMASTER.SYS) , 1-15 

slave (OSSLAVE.SYS), 1-15 
organization 

ASCII files, 2-3 

disk, 2-2 

file, 2-3 

file control block, 2-7 

memory, 1-1 
output delimiter, 4-12, 4-63 
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parse file name (C152) , 4-76 
parsing command tail, 1-10 
partial close, 4-19 
PC-DOS emulator (TPC) , D-l 
PDR packet, 5-24 
permissive open mode, 2-11 
permissive compatibility, 2-13 
physical disk access (T22), 

5-24, 5-29 
physical disk request, 5-24 
print -block- (Clll) , 4-64 
print mode, 5-30 
print string (C9) , 4-12 
PRINTER command, 5-32 
printer control, 3-7 
printer output, 3-6 
privileged log-on, 2-10, 4-36 
program interface, 1-6 . 
program load (C59) , 4-58 
program termination, 1-8, 4-2 

QUEMGR module, 4-66 to 4-72 
queue a print file (T30) , 5-33 
queue (MP/M) 

cond'l read (C138) , 4-70 

cond'l write (C140) , 4-72 

delete (C136) , 4-68 

emulation, 2-16 

make (C134) , 4-66 

open (C135) , 4-67 

read (C137) , 4-69 

write (C139), 4-71 
QUEUE command, 5-33 

raw console I/O, 3-2 
raw console input (C3) , 4-5 
raw console output (C4) , 4-6 
read console buffer (C10) , 4-13 
read queue (C137) , 4-69 
read random (C33) , 4-37 
read sequential (C20) , 4-24 
read-only file attribute, 2-9 
read-only open mode, 2-11 



rebuild disk map (Til) , 5-13 
receive I/P message (T6) , 5-8 
record locks, 2-12 
remote console I/O (T33) , 5-36 
rename file (C23) , 4-27 
reorg directory (T42), 5-45 
reserved tracks, 1-15, 2-2 
reset disk system (C13), 4-16 
reset drive (C37), 4-41 
reset O/S (TO) , 5-2 

-return 

alloc info (T19) , 5-21 
current disk (C25) , 4-29 
DMA address (C52) , 4-51 
login vector (C24) , 4-28 
phys info (T20), 5-22 
serial nr (C107), 4-61 
serial nr (T12) , 5-14 
version (C12) , 4-15 
read-only memory (ROM) , 1-15 

search for first (C17) , 4-20 
search for next (C18) , 4-22 
segmentation, 1-2 
select disk (C14) , 4-17 
send command line (T18) , 5-20 
send I/P message (T5) , 5-7 
serial I/O, 3-1 
set 

abort address (T8) , 5-10 
buffer parms (T23) , 5-26 
comm baud rate (T37) , 5-40 
compatibility (T13) , 5-15 
date and time (C104) , 4-59 
date and time (T9) , 5-11 
DMA base (C51) , 4-50 
DMA offset (C26), 4-16, 

4-30, 4-50 
error address (T7) , 5-9 
file attributes (C30), 4-34 
I/O byte (C8) , 4-11 
list (C160) , 4-80 
modem controls (T39) , 5-42 
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set 

ffiUiti-seutoi crit v^*t*.; , <*— «*o 
random record (C36) f 4-40 

shared open mode f 2-11 

sharing files, 2-10 

signal end-of-print (T28) , 5-31 

slave operating system, 1-15 

-.-_-*-! 1 -_.^,3-i1 1 __«_ 1 __0 

Diuaii uiuucj. r jl— a, j.— j 

special file names, 2-7 
stack area, 1-2 
stack group, 1-2, 1-5 
stacked command lines, 5-20 
stacked do-files, 5-18 
string console I/O, 3-2 
suspend compatibility, 2-14 
system reset (CO) , 4-2 
system start-up, 1-15 

T-function 

calling sequence, 5-1 

definition, 1-6, 1-8 

summary, F-l 
tail parsing, 1-10 
TASM assembler, A-l 
TBUG debugger, C-l 
terminate (C143) , 4-75 



terminating programs, 1-8, 4-2 

UCAL J-JLJ-CO, __ — 3 

TLINK linker, B-l 
TPC emulator, D-l 
transient program area (TPA) , 
1-1, 1-9, 5-17 

■ ml Anl/ r«/iAr/1 (f*A"i\ _ A—AA 
«-.*«._. VV» J* LCVVI.U \^-zw/ , -x =i-_ 

user number, 2-6, 2-10, 4-36 
user-defined fen (T41) , 5-44 
USRFCN routine, 5-44 

VERIFY command, 5-25, 5-28 
volume label, 2-2 

warm-start, 1-11, 4-2 
WARMSTRT.AUT, 1-11, 5-19 
wild-cards, 2-3, 2-6, 4-20, 

4-23, 4-27 
write protect disk (C28) , 4-32 
write queue (C139) , 4-71 
write random (C34) , 4-38 
write random w/zero-fill CC40), 

4-42 
write sequential (C21) , 4-25 
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